GuideTool IntegrationsAPI ReferenceTerms & Policies
API ReferenceText SeriesGemini Native ProtocolPOSTgenerateContent
Text SeriesPOSTGemini Paths
API Reference

Gemini

POSThttps://api.tokenbay.com/v1beta/models/{model}:generateContent

Native Gemini paths

Gemini Paths

Gemini generation paths carry the model name and action in the URL. The model name is not parsed from a JSON body model field.

gemini
POST/v1beta/models/{model}:generateContent
POST/v1beta/models/{model}:streamGenerateContent
POST/v1/models/{model}:generateContent
POST/v1/models/{model}:streamGenerateContent

Request

schema
modelpath stringRequired

The model name comes from the URL path.

contentsarray<object>Required

Native Gemini contents. parts may include text, inlineData, fileData, and more.

contents[].rolestringOptional

user or model.

contents[].parts[]array<object>Optional

Content block array.

parts[].textstringOptional

Text content.

parts[].inlineDataobjectOptional

Base64 inline data, usually containing mimeType and data.

parts[].fileDataobjectOptional

File input, usually containing mimeType and fileUri.

parts[].functionCallobjectOptional

Function call initiated by the model.

parts[].functionResponseobjectOptional

Function call result returned by the client.

systemInstructionobjectOptional

System instruction.

systemInstruction.parts[].textstringOptional

System instruction text.

generationConfigobjectOptional

Generation settings such as temperature, topP, topK, maxOutputTokens, stopSequences, responseMimeType, responseSchema, and thinkingConfig.

generationConfig.temperaturenumberOptional

Sampling temperature.

generationConfig.topP / topKnumberOptional

Sampling controls.

generationConfig.maxOutputTokensintegerOptional

Maximum output tokens.

generationConfig.stopSequencesstring[]Optional

Stop sequences.

generationConfig.responseMimeTypestringOptional

Response MIME type, such as application/json.

generationConfig.responseSchemaobjectOptional

Structured output schema.

generationConfig.responseModalitiesstring[]Optional

Requested output modalities.

generationConfig.thinkingConfigobjectOptional

Thinking/reasoning configuration.

safetySettingsarray<object>Optional

Safety policy configuration.

safetySettings[].categorystringOptional

Safety category.

safetySettings[].thresholdstringOptional

Blocking threshold.

tools / toolConfigarray<object> | objectOptional

Function calling or tool configuration.

tools[].functionDeclarations[]array<object>Optional

Function declarations.

functionDeclarations[].namestringOptional

Function name.

functionDeclarations[].descriptionstringOptional

Function description.

functionDeclarations[].parametersobjectOptional

Function parameter schema.

toolConfig.functionCallingConfig.modestringOptional

Function calling mode.

Response

schema

Non-streaming responses keep the Gemini generateContent shape. Streaming calls return Gemini streaming events.

candidates[]array<object>Optional

Candidate outputs, usually containing content, finishReason, safetyRatings, and similar fields.

candidates[].content.parts[]array<object>Optional

Output content blocks.

parts[].textstringOptional

Text output.

parts[].functionCallobjectOptional

Function call output.

candidates[].finishReasonstringOptional

Stop reason.

candidates[].safetyRatings[]array<object>Optional

Safety ratings.

usageMetadataobjectOptional

Token usage statistics.

usageMetadata.promptTokenCountintegerOptional

Input token count.

usageMetadata.candidatesTokenCountintegerOptional

Candidate output token count.

usageMetadata.totalTokenCountintegerOptional

Total token count.

modelVersionstringOptional

Model version when returned upstream.

Related

Errors