Gemini generate content (v1beta)
curl --request POST \
--url https://api.example.com/v1beta/models/{model}:generateContent \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"contents": [
{
"parts": [
{
"text": "Explain nordlys routing."
}
],
"role": "user"
}
],
"generation_config": {
"audioTimestamp": true,
"cachedContent": "<string>",
"candidateCount": 123,
"enableEnhancedCivicAnswers": true,
"frequencyPenalty": 123,
"httpOptions": {
"apiVersion": "<string>",
"baseUrl": "<string>",
"extraBody": {},
"headers": {},
"timeout": 123
},
"imageConfig": {
"aspectRatio": "<string>",
"imageSize": "<string>",
"outputCompressionQuality": 123,
"outputMimeType": "<string>"
},
"labels": {},
"logprobs": 123,
"maxOutputTokens": 123,
"mediaResolution": "<string>",
"modelSelectionConfig": {
"featureSelectionPreference": "<string>"
},
"presencePenalty": 123,
"responseJsonSchema": "<unknown>",
"responseLogprobs": true,
"responseMimeType": "<string>",
"responseModalities": [
"<string>"
],
"responseSchema": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": [
"<string>"
],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": true,
"pattern": "<string>",
"properties": {},
"propertyOrdering": [
"<string>"
],
"required": [
"<string>"
],
"title": "<string>",
"type": "<string>"
},
"routingConfig": {
"autoMode": {
"modelRoutingPreference": "<string>"
},
"manualMode": {
"modelName": "<string>"
}
},
"safetySettings": [
{
"category": "<string>",
"method": "<string>",
"threshold": "<string>"
}
],
"seed": 123,
"speechConfig": {
"languageCode": "<string>",
"multiSpeakerVoiceConfig": {
"speakerVoiceConfigs": [
{
"speaker": "<string>",
"voiceConfig": {
"prebuiltVoiceConfig": {
"voiceName": "<string>"
},
"replicatedVoiceConfig": {
"mimeType": "<string>",
"voiceSampleAudio": "aSDinaTvuI8gbWludGxpZnk="
}
}
}
]
},
"voiceConfig": {
"prebuiltVoiceConfig": {
"voiceName": "<string>"
},
"replicatedVoiceConfig": {
"mimeType": "<string>",
"voiceSampleAudio": "aSDinaTvuI8gbWludGxpZnk="
}
}
},
"stopSequences": [
"<string>"
],
"systemInstruction": {
"parts": [
{
"codeExecutionResult": {
"outcome": "<string>",
"output": "<string>"
},
"executableCode": {
"code": "<string>",
"language": "<string>"
},
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"functionCall": {
"args": {},
"id": "<string>",
"name": "<string>",
"partialArgs": [
{
"boolValue": true,
"jsonPath": "<string>",
"nullValue": "<string>",
"numberValue": 123,
"stringValue": "<string>",
"willContinue": true
}
],
"willContinue": true
},
"functionResponse": {
"id": "<string>",
"name": "<string>",
"parts": [
{
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
}
}
],
"response": {},
"scheduling": "<string>",
"willContinue": true
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
},
"mediaResolution": {
"level": "<string>",
"numTokens": 123
},
"text": "<string>",
"thought": true,
"thoughtSignature": "aSDinaTvuI8gbWludGxpZnk=",
"videoMetadata": {
"endOffset": 123,
"fps": 123,
"startOffset": 123
}
}
],
"role": "<string>"
},
"temperature": 123,
"thinkingConfig": {
"includeThoughts": true,
"thinkingBudget": 123,
"thinkingLevel": "<string>"
},
"toolConfig": {
"functionCallingConfig": {
"allowedFunctionNames": [
"<string>"
],
"mode": "<string>",
"streamFunctionCallArguments": true
},
"retrievalConfig": {
"languageCode": "<string>",
"latLng": {
"latitude": 123,
"longitude": 123
}
}
},
"tools": [
{
"codeExecution": {},
"computerUse": {
"environment": "<string>",
"excludedPredefinedFunctions": [
"<string>"
]
},
"enterpriseWebSearch": {
"blockingConfidence": "<string>",
"excludeDomains": [
"<string>"
]
},
"fileSearch": {
"fileSearchStoreNames": [
"<string>"
],
"metadataFilter": "<string>",
"topK": 123
},
"functionDeclarations": [
{
"behavior": "<string>",
"description": "<string>",
"name": "<string>",
"parameters": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": [
"<string>"
],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": true,
"pattern": "<string>",
"properties": {},
"propertyOrdering": [
"<string>"
],
"required": [
"<string>"
],
"title": "<string>",
"type": "<string>"
},
"parametersJsonSchema": "<unknown>",
"response": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": [
"<string>"
],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": true,
"pattern": "<string>",
"properties": {},
"propertyOrdering": [
"<string>"
],
"required": [
"<string>"
],
"title": "<string>",
"type": "<string>"
},
"responseJsonSchema": "<unknown>"
}
],
"googleMaps": {
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": {
"serviceAccount": "<string>"
},
"httpBasicAuthConfig": {
"credentialSecret": "<string>"
},
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"enableWidget": true
},
"googleSearch": {
"blockingConfidence": "<string>",
"excludeDomains": [
"<string>"
],
"timeRangeFilter": {
"endTime": "2023-11-07T05:31:56Z",
"startTime": "2023-11-07T05:31:56Z"
}
},
"googleSearchRetrieval": {
"dynamicRetrievalConfig": {
"dynamicThreshold": 123,
"mode": "<string>"
}
},
"retrieval": {
"disableAttribution": true,
"externalApi": {
"apiAuth": {
"apiKeyConfig": {
"apiKeySecretVersion": "<string>",
"apiKeyString": "<string>"
}
},
"apiSpec": "<string>",
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": {
"serviceAccount": "<string>"
},
"httpBasicAuthConfig": {
"credentialSecret": "<string>"
},
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"elasticSearchParams": {
"index": "<string>",
"numHits": 123,
"searchTemplate": "<string>"
},
"endpoint": "<string>",
"simpleSearchParams": {}
},
"vertexAiSearch": {
"dataStoreSpecs": [
{
"dataStore": "<string>",
"filter": "<string>"
}
],
"datastore": "<string>",
"engine": "<string>",
"filter": "<string>",
"maxResults": 123
},
"vertexRagStore": {
"ragCorpora": [
"<string>"
],
"ragResources": [
{
"ragCorpus": "<string>",
"ragFileIds": [
"<string>"
]
}
],
"ragRetrievalConfig": {
"filter": {
"metadataFilter": "<string>",
"vectorDistanceThreshold": 123,
"vectorSimilarityThreshold": 123
},
"hybridSearch": {
"alpha": 123
},
"ranking": {
"llmRanker": {
"modelName": "<string>"
},
"rankService": {
"modelName": "<string>"
}
},
"topK": 123
},
"similarityTopK": 123,
"storeContext": true,
"vectorDistanceThreshold": 123
}
},
"urlContext": {}
}
],
"topK": 123,
"topP": 123
},
"model": "gemini-3-pro-preview",
"models": [
"<string>"
],
"provider_configs": {},
"provider_data_collection": "<string>",
"provider_enforce_distillable_text": true,
"provider_ignore": [
"<string>"
],
"provider_max_completion_price": 123,
"provider_max_image_price": 123,
"provider_max_prompt_price": 123,
"provider_max_request_price": 123,
"provider_only": [
"<string>"
],
"provider_order": [
"<string>"
],
"provider_quantizations": [
"<string>"
],
"provider_require_parameters": true,
"provider_sort": "<string>",
"provider_zdr": true,
"safety_settings": [
{
"category": "<string>",
"method": "<string>",
"threshold": "<string>"
}
],
"system_instruction": {
"parts": [
{
"codeExecutionResult": {
"outcome": "<string>",
"output": "<string>"
},
"executableCode": {
"code": "<string>",
"language": "<string>"
},
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"functionCall": {
"args": {},
"id": "<string>",
"name": "<string>",
"partialArgs": [
{
"boolValue": true,
"jsonPath": "<string>",
"nullValue": "<string>",
"numberValue": 123,
"stringValue": "<string>",
"willContinue": true
}
],
"willContinue": true
},
"functionResponse": {
"id": "<string>",
"name": "<string>",
"parts": [
{
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
}
}
],
"response": {},
"scheduling": "<string>",
"willContinue": true
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
},
"mediaResolution": {
"level": "<string>",
"numTokens": 123
},
"text": "<string>",
"thought": true,
"thoughtSignature": "aSDinaTvuI8gbWludGxpZnk=",
"videoMetadata": {
"endOffset": 123,
"fps": 123,
"startOffset": 123
}
}
],
"role": "<string>"
},
"tool_config": {
"functionCallingConfig": {
"allowedFunctionNames": [
"<string>"
],
"mode": "<string>",
"streamFunctionCallArguments": true
},
"retrievalConfig": {
"languageCode": "<string>",
"latLng": {
"latitude": 123,
"longitude": 123
}
}
},
"tools": [
{
"codeExecution": {},
"computerUse": {
"environment": "<string>",
"excludedPredefinedFunctions": [
"<string>"
]
},
"enterpriseWebSearch": {
"blockingConfidence": "<string>",
"excludeDomains": [
"<string>"
]
},
"fileSearch": {
"fileSearchStoreNames": [
"<string>"
],
"metadataFilter": "<string>",
"topK": 123
},
"functionDeclarations": [
{
"behavior": "<string>",
"description": "<string>",
"name": "<string>",
"parameters": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": [
"<string>"
],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": true,
"pattern": "<string>",
"properties": {},
"propertyOrdering": [
"<string>"
],
"required": [
"<string>"
],
"title": "<string>",
"type": "<string>"
},
"parametersJsonSchema": "<unknown>",
"response": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": [
"<string>"
],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": true,
"pattern": "<string>",
"properties": {},
"propertyOrdering": [
"<string>"
],
"required": [
"<string>"
],
"title": "<string>",
"type": "<string>"
},
"responseJsonSchema": "<unknown>"
}
],
"googleMaps": {
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": {
"serviceAccount": "<string>"
},
"httpBasicAuthConfig": {
"credentialSecret": "<string>"
},
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"enableWidget": true
},
"googleSearch": {
"blockingConfidence": "<string>",
"excludeDomains": [
"<string>"
],
"timeRangeFilter": {
"endTime": "2023-11-07T05:31:56Z",
"startTime": "2023-11-07T05:31:56Z"
}
},
"googleSearchRetrieval": {
"dynamicRetrievalConfig": {
"dynamicThreshold": 123,
"mode": "<string>"
}
},
"retrieval": {
"disableAttribution": true,
"externalApi": {
"apiAuth": {
"apiKeyConfig": {
"apiKeySecretVersion": "<string>",
"apiKeyString": "<string>"
}
},
"apiSpec": "<string>",
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": {
"serviceAccount": "<string>"
},
"httpBasicAuthConfig": {
"credentialSecret": "<string>"
},
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"elasticSearchParams": {
"index": "<string>",
"numHits": 123,
"searchTemplate": "<string>"
},
"endpoint": "<string>",
"simpleSearchParams": {}
},
"vertexAiSearch": {
"dataStoreSpecs": [
{
"dataStore": "<string>",
"filter": "<string>"
}
],
"datastore": "<string>",
"engine": "<string>",
"filter": "<string>",
"maxResults": 123
},
"vertexRagStore": {
"ragCorpora": [
"<string>"
],
"ragResources": [
{
"ragCorpus": "<string>",
"ragFileIds": [
"<string>"
]
}
],
"ragRetrievalConfig": {
"filter": {
"metadataFilter": "<string>",
"vectorDistanceThreshold": 123,
"vectorSimilarityThreshold": 123
},
"hybridSearch": {
"alpha": 123
},
"ranking": {
"llmRanker": {
"modelName": "<string>"
},
"rankService": {
"modelName": "<string>"
}
},
"topK": 123
},
"similarityTopK": 123,
"storeContext": true,
"vectorDistanceThreshold": 123
}
},
"urlContext": {}
}
]
}
'import requests
url = "https://api.example.com/v1beta/models/{model}:generateContent"
payload = {
"contents": [
{
"parts": [{ "text": "Explain nordlys routing." }],
"role": "user"
}
],
"generation_config": {
"audioTimestamp": True,
"cachedContent": "<string>",
"candidateCount": 123,
"enableEnhancedCivicAnswers": True,
"frequencyPenalty": 123,
"httpOptions": {
"apiVersion": "<string>",
"baseUrl": "<string>",
"extraBody": {},
"headers": {},
"timeout": 123
},
"imageConfig": {
"aspectRatio": "<string>",
"imageSize": "<string>",
"outputCompressionQuality": 123,
"outputMimeType": "<string>"
},
"labels": {},
"logprobs": 123,
"maxOutputTokens": 123,
"mediaResolution": "<string>",
"modelSelectionConfig": { "featureSelectionPreference": "<string>" },
"presencePenalty": 123,
"responseJsonSchema": "<unknown>",
"responseLogprobs": True,
"responseMimeType": "<string>",
"responseModalities": ["<string>"],
"responseSchema": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": ["<string>"],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": True,
"pattern": "<string>",
"properties": {},
"propertyOrdering": ["<string>"],
"required": ["<string>"],
"title": "<string>",
"type": "<string>"
},
"routingConfig": {
"autoMode": { "modelRoutingPreference": "<string>" },
"manualMode": { "modelName": "<string>" }
},
"safetySettings": [
{
"category": "<string>",
"method": "<string>",
"threshold": "<string>"
}
],
"seed": 123,
"speechConfig": {
"languageCode": "<string>",
"multiSpeakerVoiceConfig": { "speakerVoiceConfigs": [
{
"speaker": "<string>",
"voiceConfig": {
"prebuiltVoiceConfig": { "voiceName": "<string>" },
"replicatedVoiceConfig": {
"mimeType": "<string>",
"voiceSampleAudio": "aSDinaTvuI8gbWludGxpZnk="
}
}
}
] },
"voiceConfig": {
"prebuiltVoiceConfig": { "voiceName": "<string>" },
"replicatedVoiceConfig": {
"mimeType": "<string>",
"voiceSampleAudio": "aSDinaTvuI8gbWludGxpZnk="
}
}
},
"stopSequences": ["<string>"],
"systemInstruction": {
"parts": [
{
"codeExecutionResult": {
"outcome": "<string>",
"output": "<string>"
},
"executableCode": {
"code": "<string>",
"language": "<string>"
},
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"functionCall": {
"args": {},
"id": "<string>",
"name": "<string>",
"partialArgs": [
{
"boolValue": True,
"jsonPath": "<string>",
"nullValue": "<string>",
"numberValue": 123,
"stringValue": "<string>",
"willContinue": True
}
],
"willContinue": True
},
"functionResponse": {
"id": "<string>",
"name": "<string>",
"parts": [
{
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
}
}
],
"response": {},
"scheduling": "<string>",
"willContinue": True
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
},
"mediaResolution": {
"level": "<string>",
"numTokens": 123
},
"text": "<string>",
"thought": True,
"thoughtSignature": "aSDinaTvuI8gbWludGxpZnk=",
"videoMetadata": {
"endOffset": 123,
"fps": 123,
"startOffset": 123
}
}
],
"role": "<string>"
},
"temperature": 123,
"thinkingConfig": {
"includeThoughts": True,
"thinkingBudget": 123,
"thinkingLevel": "<string>"
},
"toolConfig": {
"functionCallingConfig": {
"allowedFunctionNames": ["<string>"],
"mode": "<string>",
"streamFunctionCallArguments": True
},
"retrievalConfig": {
"languageCode": "<string>",
"latLng": {
"latitude": 123,
"longitude": 123
}
}
},
"tools": [
{
"codeExecution": {},
"computerUse": {
"environment": "<string>",
"excludedPredefinedFunctions": ["<string>"]
},
"enterpriseWebSearch": {
"blockingConfidence": "<string>",
"excludeDomains": ["<string>"]
},
"fileSearch": {
"fileSearchStoreNames": ["<string>"],
"metadataFilter": "<string>",
"topK": 123
},
"functionDeclarations": [
{
"behavior": "<string>",
"description": "<string>",
"name": "<string>",
"parameters": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": ["<string>"],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": True,
"pattern": "<string>",
"properties": {},
"propertyOrdering": ["<string>"],
"required": ["<string>"],
"title": "<string>",
"type": "<string>"
},
"parametersJsonSchema": "<unknown>",
"response": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": ["<string>"],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": True,
"pattern": "<string>",
"properties": {},
"propertyOrdering": ["<string>"],
"required": ["<string>"],
"title": "<string>",
"type": "<string>"
},
"responseJsonSchema": "<unknown>"
}
],
"googleMaps": {
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": { "serviceAccount": "<string>" },
"httpBasicAuthConfig": { "credentialSecret": "<string>" },
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"enableWidget": True
},
"googleSearch": {
"blockingConfidence": "<string>",
"excludeDomains": ["<string>"],
"timeRangeFilter": {
"endTime": "2023-11-07T05:31:56Z",
"startTime": "2023-11-07T05:31:56Z"
}
},
"googleSearchRetrieval": { "dynamicRetrievalConfig": {
"dynamicThreshold": 123,
"mode": "<string>"
} },
"retrieval": {
"disableAttribution": True,
"externalApi": {
"apiAuth": { "apiKeyConfig": {
"apiKeySecretVersion": "<string>",
"apiKeyString": "<string>"
} },
"apiSpec": "<string>",
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": { "serviceAccount": "<string>" },
"httpBasicAuthConfig": { "credentialSecret": "<string>" },
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"elasticSearchParams": {
"index": "<string>",
"numHits": 123,
"searchTemplate": "<string>"
},
"endpoint": "<string>",
"simpleSearchParams": {}
},
"vertexAiSearch": {
"dataStoreSpecs": [
{
"dataStore": "<string>",
"filter": "<string>"
}
],
"datastore": "<string>",
"engine": "<string>",
"filter": "<string>",
"maxResults": 123
},
"vertexRagStore": {
"ragCorpora": ["<string>"],
"ragResources": [
{
"ragCorpus": "<string>",
"ragFileIds": ["<string>"]
}
],
"ragRetrievalConfig": {
"filter": {
"metadataFilter": "<string>",
"vectorDistanceThreshold": 123,
"vectorSimilarityThreshold": 123
},
"hybridSearch": { "alpha": 123 },
"ranking": {
"llmRanker": { "modelName": "<string>" },
"rankService": { "modelName": "<string>" }
},
"topK": 123
},
"similarityTopK": 123,
"storeContext": True,
"vectorDistanceThreshold": 123
}
},
"urlContext": {}
}
],
"topK": 123,
"topP": 123
},
"model": "gemini-3-pro-preview",
"models": ["<string>"],
"provider_configs": {},
"provider_data_collection": "<string>",
"provider_enforce_distillable_text": True,
"provider_ignore": ["<string>"],
"provider_max_completion_price": 123,
"provider_max_image_price": 123,
"provider_max_prompt_price": 123,
"provider_max_request_price": 123,
"provider_only": ["<string>"],
"provider_order": ["<string>"],
"provider_quantizations": ["<string>"],
"provider_require_parameters": True,
"provider_sort": "<string>",
"provider_zdr": True,
"safety_settings": [
{
"category": "<string>",
"method": "<string>",
"threshold": "<string>"
}
],
"system_instruction": {
"parts": [
{
"codeExecutionResult": {
"outcome": "<string>",
"output": "<string>"
},
"executableCode": {
"code": "<string>",
"language": "<string>"
},
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"functionCall": {
"args": {},
"id": "<string>",
"name": "<string>",
"partialArgs": [
{
"boolValue": True,
"jsonPath": "<string>",
"nullValue": "<string>",
"numberValue": 123,
"stringValue": "<string>",
"willContinue": True
}
],
"willContinue": True
},
"functionResponse": {
"id": "<string>",
"name": "<string>",
"parts": [
{
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
}
}
],
"response": {},
"scheduling": "<string>",
"willContinue": True
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
},
"mediaResolution": {
"level": "<string>",
"numTokens": 123
},
"text": "<string>",
"thought": True,
"thoughtSignature": "aSDinaTvuI8gbWludGxpZnk=",
"videoMetadata": {
"endOffset": 123,
"fps": 123,
"startOffset": 123
}
}
],
"role": "<string>"
},
"tool_config": {
"functionCallingConfig": {
"allowedFunctionNames": ["<string>"],
"mode": "<string>",
"streamFunctionCallArguments": True
},
"retrievalConfig": {
"languageCode": "<string>",
"latLng": {
"latitude": 123,
"longitude": 123
}
}
},
"tools": [
{
"codeExecution": {},
"computerUse": {
"environment": "<string>",
"excludedPredefinedFunctions": ["<string>"]
},
"enterpriseWebSearch": {
"blockingConfidence": "<string>",
"excludeDomains": ["<string>"]
},
"fileSearch": {
"fileSearchStoreNames": ["<string>"],
"metadataFilter": "<string>",
"topK": 123
},
"functionDeclarations": [
{
"behavior": "<string>",
"description": "<string>",
"name": "<string>",
"parameters": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": ["<string>"],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": True,
"pattern": "<string>",
"properties": {},
"propertyOrdering": ["<string>"],
"required": ["<string>"],
"title": "<string>",
"type": "<string>"
},
"parametersJsonSchema": "<unknown>",
"response": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": ["<string>"],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": True,
"pattern": "<string>",
"properties": {},
"propertyOrdering": ["<string>"],
"required": ["<string>"],
"title": "<string>",
"type": "<string>"
},
"responseJsonSchema": "<unknown>"
}
],
"googleMaps": {
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": { "serviceAccount": "<string>" },
"httpBasicAuthConfig": { "credentialSecret": "<string>" },
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"enableWidget": True
},
"googleSearch": {
"blockingConfidence": "<string>",
"excludeDomains": ["<string>"],
"timeRangeFilter": {
"endTime": "2023-11-07T05:31:56Z",
"startTime": "2023-11-07T05:31:56Z"
}
},
"googleSearchRetrieval": { "dynamicRetrievalConfig": {
"dynamicThreshold": 123,
"mode": "<string>"
} },
"retrieval": {
"disableAttribution": True,
"externalApi": {
"apiAuth": { "apiKeyConfig": {
"apiKeySecretVersion": "<string>",
"apiKeyString": "<string>"
} },
"apiSpec": "<string>",
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": { "serviceAccount": "<string>" },
"httpBasicAuthConfig": { "credentialSecret": "<string>" },
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"elasticSearchParams": {
"index": "<string>",
"numHits": 123,
"searchTemplate": "<string>"
},
"endpoint": "<string>",
"simpleSearchParams": {}
},
"vertexAiSearch": {
"dataStoreSpecs": [
{
"dataStore": "<string>",
"filter": "<string>"
}
],
"datastore": "<string>",
"engine": "<string>",
"filter": "<string>",
"maxResults": 123
},
"vertexRagStore": {
"ragCorpora": ["<string>"],
"ragResources": [
{
"ragCorpus": "<string>",
"ragFileIds": ["<string>"]
}
],
"ragRetrievalConfig": {
"filter": {
"metadataFilter": "<string>",
"vectorDistanceThreshold": 123,
"vectorSimilarityThreshold": 123
},
"hybridSearch": { "alpha": 123 },
"ranking": {
"llmRanker": { "modelName": "<string>" },
"rankService": { "modelName": "<string>" }
},
"topK": 123
},
"similarityTopK": 123,
"storeContext": True,
"vectorDistanceThreshold": 123
}
},
"urlContext": {}
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
contents: [{parts: [{text: 'Explain nordlys routing.'}], role: 'user'}],
generation_config: {
audioTimestamp: true,
cachedContent: '<string>',
candidateCount: 123,
enableEnhancedCivicAnswers: true,
frequencyPenalty: 123,
httpOptions: {
apiVersion: '<string>',
baseUrl: '<string>',
extraBody: {},
headers: {},
timeout: 123
},
imageConfig: {
aspectRatio: '<string>',
imageSize: '<string>',
outputCompressionQuality: 123,
outputMimeType: '<string>'
},
labels: {},
logprobs: 123,
maxOutputTokens: 123,
mediaResolution: '<string>',
modelSelectionConfig: {featureSelectionPreference: '<string>'},
presencePenalty: 123,
responseJsonSchema: '<unknown>',
responseLogprobs: true,
responseMimeType: '<string>',
responseModalities: ['<string>'],
responseSchema: {
anyOf: '<array>',
default: '<unknown>',
description: '<string>',
enum: ['<string>'],
example: '<unknown>',
format: '<string>',
items: '<unknown>',
maxItems: 123,
maxLength: 123,
maxProperties: 123,
maximum: 123,
minItems: 123,
minLength: 123,
minProperties: 123,
minimum: 123,
nullable: true,
pattern: '<string>',
properties: {},
propertyOrdering: ['<string>'],
required: ['<string>'],
title: '<string>',
type: '<string>'
},
routingConfig: {
autoMode: {modelRoutingPreference: '<string>'},
manualMode: {modelName: '<string>'}
},
safetySettings: [{category: '<string>', method: '<string>', threshold: '<string>'}],
seed: 123,
speechConfig: {
languageCode: '<string>',
multiSpeakerVoiceConfig: {
speakerVoiceConfigs: [
{
speaker: '<string>',
voiceConfig: {
prebuiltVoiceConfig: {voiceName: '<string>'},
replicatedVoiceConfig: {mimeType: '<string>', voiceSampleAudio: 'aSDinaTvuI8gbWludGxpZnk='}
}
}
]
},
voiceConfig: {
prebuiltVoiceConfig: {voiceName: '<string>'},
replicatedVoiceConfig: {mimeType: '<string>', voiceSampleAudio: 'aSDinaTvuI8gbWludGxpZnk='}
}
},
stopSequences: ['<string>'],
systemInstruction: {
parts: [
{
codeExecutionResult: {outcome: '<string>', output: '<string>'},
executableCode: {code: '<string>', language: '<string>'},
fileData: {displayName: '<string>', fileUri: '<string>', mimeType: '<string>'},
functionCall: {
args: {},
id: '<string>',
name: '<string>',
partialArgs: [
{
boolValue: true,
jsonPath: '<string>',
nullValue: '<string>',
numberValue: 123,
stringValue: '<string>',
willContinue: true
}
],
willContinue: true
},
functionResponse: {
id: '<string>',
name: '<string>',
parts: [
{
fileData: {displayName: '<string>', fileUri: '<string>', mimeType: '<string>'},
inlineData: {
data: 'aSDinaTvuI8gbWludGxpZnk=',
displayName: '<string>',
mimeType: '<string>'
}
}
],
response: {},
scheduling: '<string>',
willContinue: true
},
inlineData: {
data: 'aSDinaTvuI8gbWludGxpZnk=',
displayName: '<string>',
mimeType: '<string>'
},
mediaResolution: {level: '<string>', numTokens: 123},
text: '<string>',
thought: true,
thoughtSignature: 'aSDinaTvuI8gbWludGxpZnk=',
videoMetadata: {endOffset: 123, fps: 123, startOffset: 123}
}
],
role: '<string>'
},
temperature: 123,
thinkingConfig: {includeThoughts: true, thinkingBudget: 123, thinkingLevel: '<string>'},
toolConfig: {
functionCallingConfig: {
allowedFunctionNames: ['<string>'],
mode: '<string>',
streamFunctionCallArguments: true
},
retrievalConfig: {languageCode: '<string>', latLng: {latitude: 123, longitude: 123}}
},
tools: [
{
codeExecution: {},
computerUse: {environment: '<string>', excludedPredefinedFunctions: ['<string>']},
enterpriseWebSearch: {blockingConfidence: '<string>', excludeDomains: ['<string>']},
fileSearch: {fileSearchStoreNames: ['<string>'], metadataFilter: '<string>', topK: 123},
functionDeclarations: [
{
behavior: '<string>',
description: '<string>',
name: '<string>',
parameters: {
anyOf: '<array>',
default: '<unknown>',
description: '<string>',
enum: ['<string>'],
example: '<unknown>',
format: '<string>',
items: '<unknown>',
maxItems: 123,
maxLength: 123,
maxProperties: 123,
maximum: 123,
minItems: 123,
minLength: 123,
minProperties: 123,
minimum: 123,
nullable: true,
pattern: '<string>',
properties: {},
propertyOrdering: ['<string>'],
required: ['<string>'],
title: '<string>',
type: '<string>'
},
parametersJsonSchema: '<unknown>',
response: {
anyOf: '<array>',
default: '<unknown>',
description: '<string>',
enum: ['<string>'],
example: '<unknown>',
format: '<string>',
items: '<unknown>',
maxItems: 123,
maxLength: 123,
maxProperties: 123,
maximum: 123,
minItems: 123,
minLength: 123,
minProperties: 123,
minimum: 123,
nullable: true,
pattern: '<string>',
properties: {},
propertyOrdering: ['<string>'],
required: ['<string>'],
title: '<string>',
type: '<string>'
},
responseJsonSchema: '<unknown>'
}
],
googleMaps: {
authConfig: {
apiKeyConfig: {
apiKeySecret: '<string>',
apiKeyString: '<string>',
httpElementLocation: '<string>',
name: '<string>'
},
authType: '<string>',
googleServiceAccountConfig: {serviceAccount: '<string>'},
httpBasicAuthConfig: {credentialSecret: '<string>'},
oauthConfig: {accessToken: '<string>', serviceAccount: '<string>'},
oidcConfig: {idToken: '<string>', serviceAccount: '<string>'}
},
enableWidget: true
},
googleSearch: {
blockingConfidence: '<string>',
excludeDomains: ['<string>'],
timeRangeFilter: {endTime: '2023-11-07T05:31:56Z', startTime: '2023-11-07T05:31:56Z'}
},
googleSearchRetrieval: {dynamicRetrievalConfig: {dynamicThreshold: 123, mode: '<string>'}},
retrieval: {
disableAttribution: true,
externalApi: {
apiAuth: {apiKeyConfig: {apiKeySecretVersion: '<string>', apiKeyString: '<string>'}},
apiSpec: '<string>',
authConfig: {
apiKeyConfig: {
apiKeySecret: '<string>',
apiKeyString: '<string>',
httpElementLocation: '<string>',
name: '<string>'
},
authType: '<string>',
googleServiceAccountConfig: {serviceAccount: '<string>'},
httpBasicAuthConfig: {credentialSecret: '<string>'},
oauthConfig: {accessToken: '<string>', serviceAccount: '<string>'},
oidcConfig: {idToken: '<string>', serviceAccount: '<string>'}
},
elasticSearchParams: {index: '<string>', numHits: 123, searchTemplate: '<string>'},
endpoint: '<string>',
simpleSearchParams: {}
},
vertexAiSearch: {
dataStoreSpecs: [{dataStore: '<string>', filter: '<string>'}],
datastore: '<string>',
engine: '<string>',
filter: '<string>',
maxResults: 123
},
vertexRagStore: {
ragCorpora: ['<string>'],
ragResources: [{ragCorpus: '<string>', ragFileIds: ['<string>']}],
ragRetrievalConfig: {
filter: {
metadataFilter: '<string>',
vectorDistanceThreshold: 123,
vectorSimilarityThreshold: 123
},
hybridSearch: {alpha: 123},
ranking: {llmRanker: {modelName: '<string>'}, rankService: {modelName: '<string>'}},
topK: 123
},
similarityTopK: 123,
storeContext: true,
vectorDistanceThreshold: 123
}
},
urlContext: {}
}
],
topK: 123,
topP: 123
},
model: 'gemini-3-pro-preview',
models: ['<string>'],
provider_configs: {},
provider_data_collection: '<string>',
provider_enforce_distillable_text: true,
provider_ignore: ['<string>'],
provider_max_completion_price: 123,
provider_max_image_price: 123,
provider_max_prompt_price: 123,
provider_max_request_price: 123,
provider_only: ['<string>'],
provider_order: ['<string>'],
provider_quantizations: ['<string>'],
provider_require_parameters: true,
provider_sort: '<string>',
provider_zdr: true,
safety_settings: [{category: '<string>', method: '<string>', threshold: '<string>'}],
system_instruction: {
parts: [
{
codeExecutionResult: {outcome: '<string>', output: '<string>'},
executableCode: {code: '<string>', language: '<string>'},
fileData: {displayName: '<string>', fileUri: '<string>', mimeType: '<string>'},
functionCall: {
args: {},
id: '<string>',
name: '<string>',
partialArgs: [
{
boolValue: true,
jsonPath: '<string>',
nullValue: '<string>',
numberValue: 123,
stringValue: '<string>',
willContinue: true
}
],
willContinue: true
},
functionResponse: {
id: '<string>',
name: '<string>',
parts: [
{
fileData: {displayName: '<string>', fileUri: '<string>', mimeType: '<string>'},
inlineData: {
data: 'aSDinaTvuI8gbWludGxpZnk=',
displayName: '<string>',
mimeType: '<string>'
}
}
],
response: {},
scheduling: '<string>',
willContinue: true
},
inlineData: {
data: 'aSDinaTvuI8gbWludGxpZnk=',
displayName: '<string>',
mimeType: '<string>'
},
mediaResolution: {level: '<string>', numTokens: 123},
text: '<string>',
thought: true,
thoughtSignature: 'aSDinaTvuI8gbWludGxpZnk=',
videoMetadata: {endOffset: 123, fps: 123, startOffset: 123}
}
],
role: '<string>'
},
tool_config: {
functionCallingConfig: {
allowedFunctionNames: ['<string>'],
mode: '<string>',
streamFunctionCallArguments: true
},
retrievalConfig: {languageCode: '<string>', latLng: {latitude: 123, longitude: 123}}
},
tools: [
{
codeExecution: {},
computerUse: {environment: '<string>', excludedPredefinedFunctions: ['<string>']},
enterpriseWebSearch: {blockingConfidence: '<string>', excludeDomains: ['<string>']},
fileSearch: {fileSearchStoreNames: ['<string>'], metadataFilter: '<string>', topK: 123},
functionDeclarations: [
{
behavior: '<string>',
description: '<string>',
name: '<string>',
parameters: {
anyOf: '<array>',
default: '<unknown>',
description: '<string>',
enum: ['<string>'],
example: '<unknown>',
format: '<string>',
items: '<unknown>',
maxItems: 123,
maxLength: 123,
maxProperties: 123,
maximum: 123,
minItems: 123,
minLength: 123,
minProperties: 123,
minimum: 123,
nullable: true,
pattern: '<string>',
properties: {},
propertyOrdering: ['<string>'],
required: ['<string>'],
title: '<string>',
type: '<string>'
},
parametersJsonSchema: '<unknown>',
response: {
anyOf: '<array>',
default: '<unknown>',
description: '<string>',
enum: ['<string>'],
example: '<unknown>',
format: '<string>',
items: '<unknown>',
maxItems: 123,
maxLength: 123,
maxProperties: 123,
maximum: 123,
minItems: 123,
minLength: 123,
minProperties: 123,
minimum: 123,
nullable: true,
pattern: '<string>',
properties: {},
propertyOrdering: ['<string>'],
required: ['<string>'],
title: '<string>',
type: '<string>'
},
responseJsonSchema: '<unknown>'
}
],
googleMaps: {
authConfig: {
apiKeyConfig: {
apiKeySecret: '<string>',
apiKeyString: '<string>',
httpElementLocation: '<string>',
name: '<string>'
},
authType: '<string>',
googleServiceAccountConfig: {serviceAccount: '<string>'},
httpBasicAuthConfig: {credentialSecret: '<string>'},
oauthConfig: {accessToken: '<string>', serviceAccount: '<string>'},
oidcConfig: {idToken: '<string>', serviceAccount: '<string>'}
},
enableWidget: true
},
googleSearch: {
blockingConfidence: '<string>',
excludeDomains: ['<string>'],
timeRangeFilter: {endTime: '2023-11-07T05:31:56Z', startTime: '2023-11-07T05:31:56Z'}
},
googleSearchRetrieval: {dynamicRetrievalConfig: {dynamicThreshold: 123, mode: '<string>'}},
retrieval: {
disableAttribution: true,
externalApi: {
apiAuth: {apiKeyConfig: {apiKeySecretVersion: '<string>', apiKeyString: '<string>'}},
apiSpec: '<string>',
authConfig: {
apiKeyConfig: {
apiKeySecret: '<string>',
apiKeyString: '<string>',
httpElementLocation: '<string>',
name: '<string>'
},
authType: '<string>',
googleServiceAccountConfig: {serviceAccount: '<string>'},
httpBasicAuthConfig: {credentialSecret: '<string>'},
oauthConfig: {accessToken: '<string>', serviceAccount: '<string>'},
oidcConfig: {idToken: '<string>', serviceAccount: '<string>'}
},
elasticSearchParams: {index: '<string>', numHits: 123, searchTemplate: '<string>'},
endpoint: '<string>',
simpleSearchParams: {}
},
vertexAiSearch: {
dataStoreSpecs: [{dataStore: '<string>', filter: '<string>'}],
datastore: '<string>',
engine: '<string>',
filter: '<string>',
maxResults: 123
},
vertexRagStore: {
ragCorpora: ['<string>'],
ragResources: [{ragCorpus: '<string>', ragFileIds: ['<string>']}],
ragRetrievalConfig: {
filter: {
metadataFilter: '<string>',
vectorDistanceThreshold: 123,
vectorSimilarityThreshold: 123
},
hybridSearch: {alpha: 123},
ranking: {llmRanker: {modelName: '<string>'}, rankService: {modelName: '<string>'}},
topK: 123
},
similarityTopK: 123,
storeContext: true,
vectorDistanceThreshold: 123
}
},
urlContext: {}
}
]
})
};
fetch('https://api.example.com/v1beta/models/{model}:generateContent', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"candidates": [
{
"avgLogprobs": 123,
"citationMetadata": {
"citations": [
{
"endIndex": 123,
"license": "<string>",
"publicationDate": "<string>",
"startIndex": 123,
"title": "<string>",
"uri": "<string>"
}
]
},
"content": {
"parts": [
{
"codeExecutionResult": {
"outcome": "<string>",
"output": "<string>"
},
"executableCode": {
"code": "<string>",
"language": "<string>"
},
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"functionCall": {
"args": {},
"id": "<string>",
"name": "<string>",
"partialArgs": [
{
"boolValue": true,
"jsonPath": "<string>",
"nullValue": "<string>",
"numberValue": 123,
"stringValue": "<string>",
"willContinue": true
}
],
"willContinue": true
},
"functionResponse": {
"id": "<string>",
"name": "<string>",
"parts": [
{
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
}
}
],
"response": {},
"scheduling": "<string>",
"willContinue": true
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
},
"mediaResolution": {
"level": "<string>",
"numTokens": 123
},
"text": "<string>",
"thought": true,
"thoughtSignature": "aSDinaTvuI8gbWludGxpZnk=",
"videoMetadata": {
"endOffset": 123,
"fps": 123,
"startOffset": 123
}
}
],
"role": "<string>"
},
"finishMessage": "<string>",
"finishReason": "<string>",
"groundingMetadata": {
"googleMapsWidgetContextToken": "<string>",
"groundingChunks": [
{
"maps": {
"placeAnswerSources": {
"flagContentUri": "<string>",
"reviewSnippets": [
{
"authorAttribution": {
"displayName": "<string>",
"photoUri": "<string>",
"uri": "<string>"
},
"flagContentUri": "<string>",
"googleMapsUri": "<string>",
"relativePublishTimeDescription": "<string>",
"review": "<string>",
"reviewId": "<string>",
"title": "<string>"
}
]
},
"placeId": "<string>",
"text": "<string>",
"title": "<string>",
"uri": "<string>"
},
"retrievedContext": {
"documentName": "<string>",
"ragChunk": {
"pageSpan": {
"firstPage": 123,
"lastPage": 123
},
"text": "<string>"
},
"text": "<string>",
"title": "<string>",
"uri": "<string>"
},
"web": {
"domain": "<string>",
"title": "<string>",
"uri": "<string>"
}
}
],
"groundingSupports": [
{
"confidenceScores": [
123
],
"groundingChunkIndices": [
123
],
"segment": {
"endIndex": 123,
"partIndex": 123,
"startIndex": 123,
"text": "<string>"
}
}
],
"retrievalMetadata": {
"googleSearchDynamicRetrievalScore": 123
},
"retrievalQueries": [
"<string>"
],
"searchEntryPoint": {
"renderedContent": "<string>",
"sdkBlob": "aSDinaTvuI8gbWludGxpZnk="
},
"sourceFlaggingUris": [
{
"flagContentUri": "<string>",
"sourceId": "<string>"
}
],
"webSearchQueries": [
"<string>"
]
},
"index": 123,
"logprobsResult": {
"chosenCandidates": [
{
"logProbability": 123,
"token": "<string>",
"tokenId": 123
}
],
"topCandidates": [
{
"candidates": [
{
"logProbability": 123,
"token": "<string>",
"tokenId": 123
}
]
}
]
},
"safetyRatings": [
{
"blocked": true,
"category": "<string>",
"overwrittenThreshold": "<string>",
"probability": "<string>",
"probabilityScore": 123,
"severity": "<string>",
"severityScore": 123
}
],
"tokenCount": 123,
"urlContextMetadata": {
"urlMetadata": [
{
"retrievedUrl": "<string>",
"urlRetrievalStatus": "<string>"
}
]
}
}
],
"createTime": "2023-11-07T05:31:56Z",
"modelVersion": "<string>",
"promptFeedback": {
"blockReason": "<string>",
"blockReasonMessage": "<string>",
"safetyRatings": [
{
"blocked": true,
"category": "<string>",
"overwrittenThreshold": "<string>",
"probability": "<string>",
"probabilityScore": 123,
"severity": "<string>",
"severityScore": 123
}
]
},
"responseId": "<string>",
"sdkHttpResponse": {
"body": "<string>",
"headers": {}
},
"usageMetadata": {
"cacheTokensDetails": [
{
"modality": "<string>",
"tokenCount": 123
}
],
"cachedContentTokenCount": 123,
"candidatesTokenCount": 123,
"candidatesTokensDetails": [
{
"modality": "<string>",
"tokenCount": 123
}
],
"promptTokenCount": 123,
"promptTokensDetails": [
{
"modality": "<string>",
"tokenCount": 123
}
],
"thoughtsTokenCount": 123,
"toolUsePromptTokenCount": 123,
"toolUsePromptTokensDetails": [
{
"modality": "<string>",
"tokenCount": 123
}
],
"totalTokenCount": 123,
"trafficType": "<string>"
}
}API Reference
Gemini generate content (v1beta)
Google-style endpoint that takes model from the path.
POST
/
v1beta
/
models
/
{model}
:generateContent
Gemini generate content (v1beta)
curl --request POST \
--url https://api.example.com/v1beta/models/{model}:generateContent \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"contents": [
{
"parts": [
{
"text": "Explain nordlys routing."
}
],
"role": "user"
}
],
"generation_config": {
"audioTimestamp": true,
"cachedContent": "<string>",
"candidateCount": 123,
"enableEnhancedCivicAnswers": true,
"frequencyPenalty": 123,
"httpOptions": {
"apiVersion": "<string>",
"baseUrl": "<string>",
"extraBody": {},
"headers": {},
"timeout": 123
},
"imageConfig": {
"aspectRatio": "<string>",
"imageSize": "<string>",
"outputCompressionQuality": 123,
"outputMimeType": "<string>"
},
"labels": {},
"logprobs": 123,
"maxOutputTokens": 123,
"mediaResolution": "<string>",
"modelSelectionConfig": {
"featureSelectionPreference": "<string>"
},
"presencePenalty": 123,
"responseJsonSchema": "<unknown>",
"responseLogprobs": true,
"responseMimeType": "<string>",
"responseModalities": [
"<string>"
],
"responseSchema": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": [
"<string>"
],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": true,
"pattern": "<string>",
"properties": {},
"propertyOrdering": [
"<string>"
],
"required": [
"<string>"
],
"title": "<string>",
"type": "<string>"
},
"routingConfig": {
"autoMode": {
"modelRoutingPreference": "<string>"
},
"manualMode": {
"modelName": "<string>"
}
},
"safetySettings": [
{
"category": "<string>",
"method": "<string>",
"threshold": "<string>"
}
],
"seed": 123,
"speechConfig": {
"languageCode": "<string>",
"multiSpeakerVoiceConfig": {
"speakerVoiceConfigs": [
{
"speaker": "<string>",
"voiceConfig": {
"prebuiltVoiceConfig": {
"voiceName": "<string>"
},
"replicatedVoiceConfig": {
"mimeType": "<string>",
"voiceSampleAudio": "aSDinaTvuI8gbWludGxpZnk="
}
}
}
]
},
"voiceConfig": {
"prebuiltVoiceConfig": {
"voiceName": "<string>"
},
"replicatedVoiceConfig": {
"mimeType": "<string>",
"voiceSampleAudio": "aSDinaTvuI8gbWludGxpZnk="
}
}
},
"stopSequences": [
"<string>"
],
"systemInstruction": {
"parts": [
{
"codeExecutionResult": {
"outcome": "<string>",
"output": "<string>"
},
"executableCode": {
"code": "<string>",
"language": "<string>"
},
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"functionCall": {
"args": {},
"id": "<string>",
"name": "<string>",
"partialArgs": [
{
"boolValue": true,
"jsonPath": "<string>",
"nullValue": "<string>",
"numberValue": 123,
"stringValue": "<string>",
"willContinue": true
}
],
"willContinue": true
},
"functionResponse": {
"id": "<string>",
"name": "<string>",
"parts": [
{
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
}
}
],
"response": {},
"scheduling": "<string>",
"willContinue": true
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
},
"mediaResolution": {
"level": "<string>",
"numTokens": 123
},
"text": "<string>",
"thought": true,
"thoughtSignature": "aSDinaTvuI8gbWludGxpZnk=",
"videoMetadata": {
"endOffset": 123,
"fps": 123,
"startOffset": 123
}
}
],
"role": "<string>"
},
"temperature": 123,
"thinkingConfig": {
"includeThoughts": true,
"thinkingBudget": 123,
"thinkingLevel": "<string>"
},
"toolConfig": {
"functionCallingConfig": {
"allowedFunctionNames": [
"<string>"
],
"mode": "<string>",
"streamFunctionCallArguments": true
},
"retrievalConfig": {
"languageCode": "<string>",
"latLng": {
"latitude": 123,
"longitude": 123
}
}
},
"tools": [
{
"codeExecution": {},
"computerUse": {
"environment": "<string>",
"excludedPredefinedFunctions": [
"<string>"
]
},
"enterpriseWebSearch": {
"blockingConfidence": "<string>",
"excludeDomains": [
"<string>"
]
},
"fileSearch": {
"fileSearchStoreNames": [
"<string>"
],
"metadataFilter": "<string>",
"topK": 123
},
"functionDeclarations": [
{
"behavior": "<string>",
"description": "<string>",
"name": "<string>",
"parameters": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": [
"<string>"
],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": true,
"pattern": "<string>",
"properties": {},
"propertyOrdering": [
"<string>"
],
"required": [
"<string>"
],
"title": "<string>",
"type": "<string>"
},
"parametersJsonSchema": "<unknown>",
"response": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": [
"<string>"
],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": true,
"pattern": "<string>",
"properties": {},
"propertyOrdering": [
"<string>"
],
"required": [
"<string>"
],
"title": "<string>",
"type": "<string>"
},
"responseJsonSchema": "<unknown>"
}
],
"googleMaps": {
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": {
"serviceAccount": "<string>"
},
"httpBasicAuthConfig": {
"credentialSecret": "<string>"
},
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"enableWidget": true
},
"googleSearch": {
"blockingConfidence": "<string>",
"excludeDomains": [
"<string>"
],
"timeRangeFilter": {
"endTime": "2023-11-07T05:31:56Z",
"startTime": "2023-11-07T05:31:56Z"
}
},
"googleSearchRetrieval": {
"dynamicRetrievalConfig": {
"dynamicThreshold": 123,
"mode": "<string>"
}
},
"retrieval": {
"disableAttribution": true,
"externalApi": {
"apiAuth": {
"apiKeyConfig": {
"apiKeySecretVersion": "<string>",
"apiKeyString": "<string>"
}
},
"apiSpec": "<string>",
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": {
"serviceAccount": "<string>"
},
"httpBasicAuthConfig": {
"credentialSecret": "<string>"
},
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"elasticSearchParams": {
"index": "<string>",
"numHits": 123,
"searchTemplate": "<string>"
},
"endpoint": "<string>",
"simpleSearchParams": {}
},
"vertexAiSearch": {
"dataStoreSpecs": [
{
"dataStore": "<string>",
"filter": "<string>"
}
],
"datastore": "<string>",
"engine": "<string>",
"filter": "<string>",
"maxResults": 123
},
"vertexRagStore": {
"ragCorpora": [
"<string>"
],
"ragResources": [
{
"ragCorpus": "<string>",
"ragFileIds": [
"<string>"
]
}
],
"ragRetrievalConfig": {
"filter": {
"metadataFilter": "<string>",
"vectorDistanceThreshold": 123,
"vectorSimilarityThreshold": 123
},
"hybridSearch": {
"alpha": 123
},
"ranking": {
"llmRanker": {
"modelName": "<string>"
},
"rankService": {
"modelName": "<string>"
}
},
"topK": 123
},
"similarityTopK": 123,
"storeContext": true,
"vectorDistanceThreshold": 123
}
},
"urlContext": {}
}
],
"topK": 123,
"topP": 123
},
"model": "gemini-3-pro-preview",
"models": [
"<string>"
],
"provider_configs": {},
"provider_data_collection": "<string>",
"provider_enforce_distillable_text": true,
"provider_ignore": [
"<string>"
],
"provider_max_completion_price": 123,
"provider_max_image_price": 123,
"provider_max_prompt_price": 123,
"provider_max_request_price": 123,
"provider_only": [
"<string>"
],
"provider_order": [
"<string>"
],
"provider_quantizations": [
"<string>"
],
"provider_require_parameters": true,
"provider_sort": "<string>",
"provider_zdr": true,
"safety_settings": [
{
"category": "<string>",
"method": "<string>",
"threshold": "<string>"
}
],
"system_instruction": {
"parts": [
{
"codeExecutionResult": {
"outcome": "<string>",
"output": "<string>"
},
"executableCode": {
"code": "<string>",
"language": "<string>"
},
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"functionCall": {
"args": {},
"id": "<string>",
"name": "<string>",
"partialArgs": [
{
"boolValue": true,
"jsonPath": "<string>",
"nullValue": "<string>",
"numberValue": 123,
"stringValue": "<string>",
"willContinue": true
}
],
"willContinue": true
},
"functionResponse": {
"id": "<string>",
"name": "<string>",
"parts": [
{
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
}
}
],
"response": {},
"scheduling": "<string>",
"willContinue": true
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
},
"mediaResolution": {
"level": "<string>",
"numTokens": 123
},
"text": "<string>",
"thought": true,
"thoughtSignature": "aSDinaTvuI8gbWludGxpZnk=",
"videoMetadata": {
"endOffset": 123,
"fps": 123,
"startOffset": 123
}
}
],
"role": "<string>"
},
"tool_config": {
"functionCallingConfig": {
"allowedFunctionNames": [
"<string>"
],
"mode": "<string>",
"streamFunctionCallArguments": true
},
"retrievalConfig": {
"languageCode": "<string>",
"latLng": {
"latitude": 123,
"longitude": 123
}
}
},
"tools": [
{
"codeExecution": {},
"computerUse": {
"environment": "<string>",
"excludedPredefinedFunctions": [
"<string>"
]
},
"enterpriseWebSearch": {
"blockingConfidence": "<string>",
"excludeDomains": [
"<string>"
]
},
"fileSearch": {
"fileSearchStoreNames": [
"<string>"
],
"metadataFilter": "<string>",
"topK": 123
},
"functionDeclarations": [
{
"behavior": "<string>",
"description": "<string>",
"name": "<string>",
"parameters": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": [
"<string>"
],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": true,
"pattern": "<string>",
"properties": {},
"propertyOrdering": [
"<string>"
],
"required": [
"<string>"
],
"title": "<string>",
"type": "<string>"
},
"parametersJsonSchema": "<unknown>",
"response": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": [
"<string>"
],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": true,
"pattern": "<string>",
"properties": {},
"propertyOrdering": [
"<string>"
],
"required": [
"<string>"
],
"title": "<string>",
"type": "<string>"
},
"responseJsonSchema": "<unknown>"
}
],
"googleMaps": {
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": {
"serviceAccount": "<string>"
},
"httpBasicAuthConfig": {
"credentialSecret": "<string>"
},
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"enableWidget": true
},
"googleSearch": {
"blockingConfidence": "<string>",
"excludeDomains": [
"<string>"
],
"timeRangeFilter": {
"endTime": "2023-11-07T05:31:56Z",
"startTime": "2023-11-07T05:31:56Z"
}
},
"googleSearchRetrieval": {
"dynamicRetrievalConfig": {
"dynamicThreshold": 123,
"mode": "<string>"
}
},
"retrieval": {
"disableAttribution": true,
"externalApi": {
"apiAuth": {
"apiKeyConfig": {
"apiKeySecretVersion": "<string>",
"apiKeyString": "<string>"
}
},
"apiSpec": "<string>",
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": {
"serviceAccount": "<string>"
},
"httpBasicAuthConfig": {
"credentialSecret": "<string>"
},
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"elasticSearchParams": {
"index": "<string>",
"numHits": 123,
"searchTemplate": "<string>"
},
"endpoint": "<string>",
"simpleSearchParams": {}
},
"vertexAiSearch": {
"dataStoreSpecs": [
{
"dataStore": "<string>",
"filter": "<string>"
}
],
"datastore": "<string>",
"engine": "<string>",
"filter": "<string>",
"maxResults": 123
},
"vertexRagStore": {
"ragCorpora": [
"<string>"
],
"ragResources": [
{
"ragCorpus": "<string>",
"ragFileIds": [
"<string>"
]
}
],
"ragRetrievalConfig": {
"filter": {
"metadataFilter": "<string>",
"vectorDistanceThreshold": 123,
"vectorSimilarityThreshold": 123
},
"hybridSearch": {
"alpha": 123
},
"ranking": {
"llmRanker": {
"modelName": "<string>"
},
"rankService": {
"modelName": "<string>"
}
},
"topK": 123
},
"similarityTopK": 123,
"storeContext": true,
"vectorDistanceThreshold": 123
}
},
"urlContext": {}
}
]
}
'import requests
url = "https://api.example.com/v1beta/models/{model}:generateContent"
payload = {
"contents": [
{
"parts": [{ "text": "Explain nordlys routing." }],
"role": "user"
}
],
"generation_config": {
"audioTimestamp": True,
"cachedContent": "<string>",
"candidateCount": 123,
"enableEnhancedCivicAnswers": True,
"frequencyPenalty": 123,
"httpOptions": {
"apiVersion": "<string>",
"baseUrl": "<string>",
"extraBody": {},
"headers": {},
"timeout": 123
},
"imageConfig": {
"aspectRatio": "<string>",
"imageSize": "<string>",
"outputCompressionQuality": 123,
"outputMimeType": "<string>"
},
"labels": {},
"logprobs": 123,
"maxOutputTokens": 123,
"mediaResolution": "<string>",
"modelSelectionConfig": { "featureSelectionPreference": "<string>" },
"presencePenalty": 123,
"responseJsonSchema": "<unknown>",
"responseLogprobs": True,
"responseMimeType": "<string>",
"responseModalities": ["<string>"],
"responseSchema": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": ["<string>"],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": True,
"pattern": "<string>",
"properties": {},
"propertyOrdering": ["<string>"],
"required": ["<string>"],
"title": "<string>",
"type": "<string>"
},
"routingConfig": {
"autoMode": { "modelRoutingPreference": "<string>" },
"manualMode": { "modelName": "<string>" }
},
"safetySettings": [
{
"category": "<string>",
"method": "<string>",
"threshold": "<string>"
}
],
"seed": 123,
"speechConfig": {
"languageCode": "<string>",
"multiSpeakerVoiceConfig": { "speakerVoiceConfigs": [
{
"speaker": "<string>",
"voiceConfig": {
"prebuiltVoiceConfig": { "voiceName": "<string>" },
"replicatedVoiceConfig": {
"mimeType": "<string>",
"voiceSampleAudio": "aSDinaTvuI8gbWludGxpZnk="
}
}
}
] },
"voiceConfig": {
"prebuiltVoiceConfig": { "voiceName": "<string>" },
"replicatedVoiceConfig": {
"mimeType": "<string>",
"voiceSampleAudio": "aSDinaTvuI8gbWludGxpZnk="
}
}
},
"stopSequences": ["<string>"],
"systemInstruction": {
"parts": [
{
"codeExecutionResult": {
"outcome": "<string>",
"output": "<string>"
},
"executableCode": {
"code": "<string>",
"language": "<string>"
},
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"functionCall": {
"args": {},
"id": "<string>",
"name": "<string>",
"partialArgs": [
{
"boolValue": True,
"jsonPath": "<string>",
"nullValue": "<string>",
"numberValue": 123,
"stringValue": "<string>",
"willContinue": True
}
],
"willContinue": True
},
"functionResponse": {
"id": "<string>",
"name": "<string>",
"parts": [
{
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
}
}
],
"response": {},
"scheduling": "<string>",
"willContinue": True
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
},
"mediaResolution": {
"level": "<string>",
"numTokens": 123
},
"text": "<string>",
"thought": True,
"thoughtSignature": "aSDinaTvuI8gbWludGxpZnk=",
"videoMetadata": {
"endOffset": 123,
"fps": 123,
"startOffset": 123
}
}
],
"role": "<string>"
},
"temperature": 123,
"thinkingConfig": {
"includeThoughts": True,
"thinkingBudget": 123,
"thinkingLevel": "<string>"
},
"toolConfig": {
"functionCallingConfig": {
"allowedFunctionNames": ["<string>"],
"mode": "<string>",
"streamFunctionCallArguments": True
},
"retrievalConfig": {
"languageCode": "<string>",
"latLng": {
"latitude": 123,
"longitude": 123
}
}
},
"tools": [
{
"codeExecution": {},
"computerUse": {
"environment": "<string>",
"excludedPredefinedFunctions": ["<string>"]
},
"enterpriseWebSearch": {
"blockingConfidence": "<string>",
"excludeDomains": ["<string>"]
},
"fileSearch": {
"fileSearchStoreNames": ["<string>"],
"metadataFilter": "<string>",
"topK": 123
},
"functionDeclarations": [
{
"behavior": "<string>",
"description": "<string>",
"name": "<string>",
"parameters": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": ["<string>"],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": True,
"pattern": "<string>",
"properties": {},
"propertyOrdering": ["<string>"],
"required": ["<string>"],
"title": "<string>",
"type": "<string>"
},
"parametersJsonSchema": "<unknown>",
"response": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": ["<string>"],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": True,
"pattern": "<string>",
"properties": {},
"propertyOrdering": ["<string>"],
"required": ["<string>"],
"title": "<string>",
"type": "<string>"
},
"responseJsonSchema": "<unknown>"
}
],
"googleMaps": {
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": { "serviceAccount": "<string>" },
"httpBasicAuthConfig": { "credentialSecret": "<string>" },
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"enableWidget": True
},
"googleSearch": {
"blockingConfidence": "<string>",
"excludeDomains": ["<string>"],
"timeRangeFilter": {
"endTime": "2023-11-07T05:31:56Z",
"startTime": "2023-11-07T05:31:56Z"
}
},
"googleSearchRetrieval": { "dynamicRetrievalConfig": {
"dynamicThreshold": 123,
"mode": "<string>"
} },
"retrieval": {
"disableAttribution": True,
"externalApi": {
"apiAuth": { "apiKeyConfig": {
"apiKeySecretVersion": "<string>",
"apiKeyString": "<string>"
} },
"apiSpec": "<string>",
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": { "serviceAccount": "<string>" },
"httpBasicAuthConfig": { "credentialSecret": "<string>" },
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"elasticSearchParams": {
"index": "<string>",
"numHits": 123,
"searchTemplate": "<string>"
},
"endpoint": "<string>",
"simpleSearchParams": {}
},
"vertexAiSearch": {
"dataStoreSpecs": [
{
"dataStore": "<string>",
"filter": "<string>"
}
],
"datastore": "<string>",
"engine": "<string>",
"filter": "<string>",
"maxResults": 123
},
"vertexRagStore": {
"ragCorpora": ["<string>"],
"ragResources": [
{
"ragCorpus": "<string>",
"ragFileIds": ["<string>"]
}
],
"ragRetrievalConfig": {
"filter": {
"metadataFilter": "<string>",
"vectorDistanceThreshold": 123,
"vectorSimilarityThreshold": 123
},
"hybridSearch": { "alpha": 123 },
"ranking": {
"llmRanker": { "modelName": "<string>" },
"rankService": { "modelName": "<string>" }
},
"topK": 123
},
"similarityTopK": 123,
"storeContext": True,
"vectorDistanceThreshold": 123
}
},
"urlContext": {}
}
],
"topK": 123,
"topP": 123
},
"model": "gemini-3-pro-preview",
"models": ["<string>"],
"provider_configs": {},
"provider_data_collection": "<string>",
"provider_enforce_distillable_text": True,
"provider_ignore": ["<string>"],
"provider_max_completion_price": 123,
"provider_max_image_price": 123,
"provider_max_prompt_price": 123,
"provider_max_request_price": 123,
"provider_only": ["<string>"],
"provider_order": ["<string>"],
"provider_quantizations": ["<string>"],
"provider_require_parameters": True,
"provider_sort": "<string>",
"provider_zdr": True,
"safety_settings": [
{
"category": "<string>",
"method": "<string>",
"threshold": "<string>"
}
],
"system_instruction": {
"parts": [
{
"codeExecutionResult": {
"outcome": "<string>",
"output": "<string>"
},
"executableCode": {
"code": "<string>",
"language": "<string>"
},
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"functionCall": {
"args": {},
"id": "<string>",
"name": "<string>",
"partialArgs": [
{
"boolValue": True,
"jsonPath": "<string>",
"nullValue": "<string>",
"numberValue": 123,
"stringValue": "<string>",
"willContinue": True
}
],
"willContinue": True
},
"functionResponse": {
"id": "<string>",
"name": "<string>",
"parts": [
{
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
}
}
],
"response": {},
"scheduling": "<string>",
"willContinue": True
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
},
"mediaResolution": {
"level": "<string>",
"numTokens": 123
},
"text": "<string>",
"thought": True,
"thoughtSignature": "aSDinaTvuI8gbWludGxpZnk=",
"videoMetadata": {
"endOffset": 123,
"fps": 123,
"startOffset": 123
}
}
],
"role": "<string>"
},
"tool_config": {
"functionCallingConfig": {
"allowedFunctionNames": ["<string>"],
"mode": "<string>",
"streamFunctionCallArguments": True
},
"retrievalConfig": {
"languageCode": "<string>",
"latLng": {
"latitude": 123,
"longitude": 123
}
}
},
"tools": [
{
"codeExecution": {},
"computerUse": {
"environment": "<string>",
"excludedPredefinedFunctions": ["<string>"]
},
"enterpriseWebSearch": {
"blockingConfidence": "<string>",
"excludeDomains": ["<string>"]
},
"fileSearch": {
"fileSearchStoreNames": ["<string>"],
"metadataFilter": "<string>",
"topK": 123
},
"functionDeclarations": [
{
"behavior": "<string>",
"description": "<string>",
"name": "<string>",
"parameters": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": ["<string>"],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": True,
"pattern": "<string>",
"properties": {},
"propertyOrdering": ["<string>"],
"required": ["<string>"],
"title": "<string>",
"type": "<string>"
},
"parametersJsonSchema": "<unknown>",
"response": {
"anyOf": "<array>",
"default": "<unknown>",
"description": "<string>",
"enum": ["<string>"],
"example": "<unknown>",
"format": "<string>",
"items": "<unknown>",
"maxItems": 123,
"maxLength": 123,
"maxProperties": 123,
"maximum": 123,
"minItems": 123,
"minLength": 123,
"minProperties": 123,
"minimum": 123,
"nullable": True,
"pattern": "<string>",
"properties": {},
"propertyOrdering": ["<string>"],
"required": ["<string>"],
"title": "<string>",
"type": "<string>"
},
"responseJsonSchema": "<unknown>"
}
],
"googleMaps": {
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": { "serviceAccount": "<string>" },
"httpBasicAuthConfig": { "credentialSecret": "<string>" },
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"enableWidget": True
},
"googleSearch": {
"blockingConfidence": "<string>",
"excludeDomains": ["<string>"],
"timeRangeFilter": {
"endTime": "2023-11-07T05:31:56Z",
"startTime": "2023-11-07T05:31:56Z"
}
},
"googleSearchRetrieval": { "dynamicRetrievalConfig": {
"dynamicThreshold": 123,
"mode": "<string>"
} },
"retrieval": {
"disableAttribution": True,
"externalApi": {
"apiAuth": { "apiKeyConfig": {
"apiKeySecretVersion": "<string>",
"apiKeyString": "<string>"
} },
"apiSpec": "<string>",
"authConfig": {
"apiKeyConfig": {
"apiKeySecret": "<string>",
"apiKeyString": "<string>",
"httpElementLocation": "<string>",
"name": "<string>"
},
"authType": "<string>",
"googleServiceAccountConfig": { "serviceAccount": "<string>" },
"httpBasicAuthConfig": { "credentialSecret": "<string>" },
"oauthConfig": {
"accessToken": "<string>",
"serviceAccount": "<string>"
},
"oidcConfig": {
"idToken": "<string>",
"serviceAccount": "<string>"
}
},
"elasticSearchParams": {
"index": "<string>",
"numHits": 123,
"searchTemplate": "<string>"
},
"endpoint": "<string>",
"simpleSearchParams": {}
},
"vertexAiSearch": {
"dataStoreSpecs": [
{
"dataStore": "<string>",
"filter": "<string>"
}
],
"datastore": "<string>",
"engine": "<string>",
"filter": "<string>",
"maxResults": 123
},
"vertexRagStore": {
"ragCorpora": ["<string>"],
"ragResources": [
{
"ragCorpus": "<string>",
"ragFileIds": ["<string>"]
}
],
"ragRetrievalConfig": {
"filter": {
"metadataFilter": "<string>",
"vectorDistanceThreshold": 123,
"vectorSimilarityThreshold": 123
},
"hybridSearch": { "alpha": 123 },
"ranking": {
"llmRanker": { "modelName": "<string>" },
"rankService": { "modelName": "<string>" }
},
"topK": 123
},
"similarityTopK": 123,
"storeContext": True,
"vectorDistanceThreshold": 123
}
},
"urlContext": {}
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
contents: [{parts: [{text: 'Explain nordlys routing.'}], role: 'user'}],
generation_config: {
audioTimestamp: true,
cachedContent: '<string>',
candidateCount: 123,
enableEnhancedCivicAnswers: true,
frequencyPenalty: 123,
httpOptions: {
apiVersion: '<string>',
baseUrl: '<string>',
extraBody: {},
headers: {},
timeout: 123
},
imageConfig: {
aspectRatio: '<string>',
imageSize: '<string>',
outputCompressionQuality: 123,
outputMimeType: '<string>'
},
labels: {},
logprobs: 123,
maxOutputTokens: 123,
mediaResolution: '<string>',
modelSelectionConfig: {featureSelectionPreference: '<string>'},
presencePenalty: 123,
responseJsonSchema: '<unknown>',
responseLogprobs: true,
responseMimeType: '<string>',
responseModalities: ['<string>'],
responseSchema: {
anyOf: '<array>',
default: '<unknown>',
description: '<string>',
enum: ['<string>'],
example: '<unknown>',
format: '<string>',
items: '<unknown>',
maxItems: 123,
maxLength: 123,
maxProperties: 123,
maximum: 123,
minItems: 123,
minLength: 123,
minProperties: 123,
minimum: 123,
nullable: true,
pattern: '<string>',
properties: {},
propertyOrdering: ['<string>'],
required: ['<string>'],
title: '<string>',
type: '<string>'
},
routingConfig: {
autoMode: {modelRoutingPreference: '<string>'},
manualMode: {modelName: '<string>'}
},
safetySettings: [{category: '<string>', method: '<string>', threshold: '<string>'}],
seed: 123,
speechConfig: {
languageCode: '<string>',
multiSpeakerVoiceConfig: {
speakerVoiceConfigs: [
{
speaker: '<string>',
voiceConfig: {
prebuiltVoiceConfig: {voiceName: '<string>'},
replicatedVoiceConfig: {mimeType: '<string>', voiceSampleAudio: 'aSDinaTvuI8gbWludGxpZnk='}
}
}
]
},
voiceConfig: {
prebuiltVoiceConfig: {voiceName: '<string>'},
replicatedVoiceConfig: {mimeType: '<string>', voiceSampleAudio: 'aSDinaTvuI8gbWludGxpZnk='}
}
},
stopSequences: ['<string>'],
systemInstruction: {
parts: [
{
codeExecutionResult: {outcome: '<string>', output: '<string>'},
executableCode: {code: '<string>', language: '<string>'},
fileData: {displayName: '<string>', fileUri: '<string>', mimeType: '<string>'},
functionCall: {
args: {},
id: '<string>',
name: '<string>',
partialArgs: [
{
boolValue: true,
jsonPath: '<string>',
nullValue: '<string>',
numberValue: 123,
stringValue: '<string>',
willContinue: true
}
],
willContinue: true
},
functionResponse: {
id: '<string>',
name: '<string>',
parts: [
{
fileData: {displayName: '<string>', fileUri: '<string>', mimeType: '<string>'},
inlineData: {
data: 'aSDinaTvuI8gbWludGxpZnk=',
displayName: '<string>',
mimeType: '<string>'
}
}
],
response: {},
scheduling: '<string>',
willContinue: true
},
inlineData: {
data: 'aSDinaTvuI8gbWludGxpZnk=',
displayName: '<string>',
mimeType: '<string>'
},
mediaResolution: {level: '<string>', numTokens: 123},
text: '<string>',
thought: true,
thoughtSignature: 'aSDinaTvuI8gbWludGxpZnk=',
videoMetadata: {endOffset: 123, fps: 123, startOffset: 123}
}
],
role: '<string>'
},
temperature: 123,
thinkingConfig: {includeThoughts: true, thinkingBudget: 123, thinkingLevel: '<string>'},
toolConfig: {
functionCallingConfig: {
allowedFunctionNames: ['<string>'],
mode: '<string>',
streamFunctionCallArguments: true
},
retrievalConfig: {languageCode: '<string>', latLng: {latitude: 123, longitude: 123}}
},
tools: [
{
codeExecution: {},
computerUse: {environment: '<string>', excludedPredefinedFunctions: ['<string>']},
enterpriseWebSearch: {blockingConfidence: '<string>', excludeDomains: ['<string>']},
fileSearch: {fileSearchStoreNames: ['<string>'], metadataFilter: '<string>', topK: 123},
functionDeclarations: [
{
behavior: '<string>',
description: '<string>',
name: '<string>',
parameters: {
anyOf: '<array>',
default: '<unknown>',
description: '<string>',
enum: ['<string>'],
example: '<unknown>',
format: '<string>',
items: '<unknown>',
maxItems: 123,
maxLength: 123,
maxProperties: 123,
maximum: 123,
minItems: 123,
minLength: 123,
minProperties: 123,
minimum: 123,
nullable: true,
pattern: '<string>',
properties: {},
propertyOrdering: ['<string>'],
required: ['<string>'],
title: '<string>',
type: '<string>'
},
parametersJsonSchema: '<unknown>',
response: {
anyOf: '<array>',
default: '<unknown>',
description: '<string>',
enum: ['<string>'],
example: '<unknown>',
format: '<string>',
items: '<unknown>',
maxItems: 123,
maxLength: 123,
maxProperties: 123,
maximum: 123,
minItems: 123,
minLength: 123,
minProperties: 123,
minimum: 123,
nullable: true,
pattern: '<string>',
properties: {},
propertyOrdering: ['<string>'],
required: ['<string>'],
title: '<string>',
type: '<string>'
},
responseJsonSchema: '<unknown>'
}
],
googleMaps: {
authConfig: {
apiKeyConfig: {
apiKeySecret: '<string>',
apiKeyString: '<string>',
httpElementLocation: '<string>',
name: '<string>'
},
authType: '<string>',
googleServiceAccountConfig: {serviceAccount: '<string>'},
httpBasicAuthConfig: {credentialSecret: '<string>'},
oauthConfig: {accessToken: '<string>', serviceAccount: '<string>'},
oidcConfig: {idToken: '<string>', serviceAccount: '<string>'}
},
enableWidget: true
},
googleSearch: {
blockingConfidence: '<string>',
excludeDomains: ['<string>'],
timeRangeFilter: {endTime: '2023-11-07T05:31:56Z', startTime: '2023-11-07T05:31:56Z'}
},
googleSearchRetrieval: {dynamicRetrievalConfig: {dynamicThreshold: 123, mode: '<string>'}},
retrieval: {
disableAttribution: true,
externalApi: {
apiAuth: {apiKeyConfig: {apiKeySecretVersion: '<string>', apiKeyString: '<string>'}},
apiSpec: '<string>',
authConfig: {
apiKeyConfig: {
apiKeySecret: '<string>',
apiKeyString: '<string>',
httpElementLocation: '<string>',
name: '<string>'
},
authType: '<string>',
googleServiceAccountConfig: {serviceAccount: '<string>'},
httpBasicAuthConfig: {credentialSecret: '<string>'},
oauthConfig: {accessToken: '<string>', serviceAccount: '<string>'},
oidcConfig: {idToken: '<string>', serviceAccount: '<string>'}
},
elasticSearchParams: {index: '<string>', numHits: 123, searchTemplate: '<string>'},
endpoint: '<string>',
simpleSearchParams: {}
},
vertexAiSearch: {
dataStoreSpecs: [{dataStore: '<string>', filter: '<string>'}],
datastore: '<string>',
engine: '<string>',
filter: '<string>',
maxResults: 123
},
vertexRagStore: {
ragCorpora: ['<string>'],
ragResources: [{ragCorpus: '<string>', ragFileIds: ['<string>']}],
ragRetrievalConfig: {
filter: {
metadataFilter: '<string>',
vectorDistanceThreshold: 123,
vectorSimilarityThreshold: 123
},
hybridSearch: {alpha: 123},
ranking: {llmRanker: {modelName: '<string>'}, rankService: {modelName: '<string>'}},
topK: 123
},
similarityTopK: 123,
storeContext: true,
vectorDistanceThreshold: 123
}
},
urlContext: {}
}
],
topK: 123,
topP: 123
},
model: 'gemini-3-pro-preview',
models: ['<string>'],
provider_configs: {},
provider_data_collection: '<string>',
provider_enforce_distillable_text: true,
provider_ignore: ['<string>'],
provider_max_completion_price: 123,
provider_max_image_price: 123,
provider_max_prompt_price: 123,
provider_max_request_price: 123,
provider_only: ['<string>'],
provider_order: ['<string>'],
provider_quantizations: ['<string>'],
provider_require_parameters: true,
provider_sort: '<string>',
provider_zdr: true,
safety_settings: [{category: '<string>', method: '<string>', threshold: '<string>'}],
system_instruction: {
parts: [
{
codeExecutionResult: {outcome: '<string>', output: '<string>'},
executableCode: {code: '<string>', language: '<string>'},
fileData: {displayName: '<string>', fileUri: '<string>', mimeType: '<string>'},
functionCall: {
args: {},
id: '<string>',
name: '<string>',
partialArgs: [
{
boolValue: true,
jsonPath: '<string>',
nullValue: '<string>',
numberValue: 123,
stringValue: '<string>',
willContinue: true
}
],
willContinue: true
},
functionResponse: {
id: '<string>',
name: '<string>',
parts: [
{
fileData: {displayName: '<string>', fileUri: '<string>', mimeType: '<string>'},
inlineData: {
data: 'aSDinaTvuI8gbWludGxpZnk=',
displayName: '<string>',
mimeType: '<string>'
}
}
],
response: {},
scheduling: '<string>',
willContinue: true
},
inlineData: {
data: 'aSDinaTvuI8gbWludGxpZnk=',
displayName: '<string>',
mimeType: '<string>'
},
mediaResolution: {level: '<string>', numTokens: 123},
text: '<string>',
thought: true,
thoughtSignature: 'aSDinaTvuI8gbWludGxpZnk=',
videoMetadata: {endOffset: 123, fps: 123, startOffset: 123}
}
],
role: '<string>'
},
tool_config: {
functionCallingConfig: {
allowedFunctionNames: ['<string>'],
mode: '<string>',
streamFunctionCallArguments: true
},
retrievalConfig: {languageCode: '<string>', latLng: {latitude: 123, longitude: 123}}
},
tools: [
{
codeExecution: {},
computerUse: {environment: '<string>', excludedPredefinedFunctions: ['<string>']},
enterpriseWebSearch: {blockingConfidence: '<string>', excludeDomains: ['<string>']},
fileSearch: {fileSearchStoreNames: ['<string>'], metadataFilter: '<string>', topK: 123},
functionDeclarations: [
{
behavior: '<string>',
description: '<string>',
name: '<string>',
parameters: {
anyOf: '<array>',
default: '<unknown>',
description: '<string>',
enum: ['<string>'],
example: '<unknown>',
format: '<string>',
items: '<unknown>',
maxItems: 123,
maxLength: 123,
maxProperties: 123,
maximum: 123,
minItems: 123,
minLength: 123,
minProperties: 123,
minimum: 123,
nullable: true,
pattern: '<string>',
properties: {},
propertyOrdering: ['<string>'],
required: ['<string>'],
title: '<string>',
type: '<string>'
},
parametersJsonSchema: '<unknown>',
response: {
anyOf: '<array>',
default: '<unknown>',
description: '<string>',
enum: ['<string>'],
example: '<unknown>',
format: '<string>',
items: '<unknown>',
maxItems: 123,
maxLength: 123,
maxProperties: 123,
maximum: 123,
minItems: 123,
minLength: 123,
minProperties: 123,
minimum: 123,
nullable: true,
pattern: '<string>',
properties: {},
propertyOrdering: ['<string>'],
required: ['<string>'],
title: '<string>',
type: '<string>'
},
responseJsonSchema: '<unknown>'
}
],
googleMaps: {
authConfig: {
apiKeyConfig: {
apiKeySecret: '<string>',
apiKeyString: '<string>',
httpElementLocation: '<string>',
name: '<string>'
},
authType: '<string>',
googleServiceAccountConfig: {serviceAccount: '<string>'},
httpBasicAuthConfig: {credentialSecret: '<string>'},
oauthConfig: {accessToken: '<string>', serviceAccount: '<string>'},
oidcConfig: {idToken: '<string>', serviceAccount: '<string>'}
},
enableWidget: true
},
googleSearch: {
blockingConfidence: '<string>',
excludeDomains: ['<string>'],
timeRangeFilter: {endTime: '2023-11-07T05:31:56Z', startTime: '2023-11-07T05:31:56Z'}
},
googleSearchRetrieval: {dynamicRetrievalConfig: {dynamicThreshold: 123, mode: '<string>'}},
retrieval: {
disableAttribution: true,
externalApi: {
apiAuth: {apiKeyConfig: {apiKeySecretVersion: '<string>', apiKeyString: '<string>'}},
apiSpec: '<string>',
authConfig: {
apiKeyConfig: {
apiKeySecret: '<string>',
apiKeyString: '<string>',
httpElementLocation: '<string>',
name: '<string>'
},
authType: '<string>',
googleServiceAccountConfig: {serviceAccount: '<string>'},
httpBasicAuthConfig: {credentialSecret: '<string>'},
oauthConfig: {accessToken: '<string>', serviceAccount: '<string>'},
oidcConfig: {idToken: '<string>', serviceAccount: '<string>'}
},
elasticSearchParams: {index: '<string>', numHits: 123, searchTemplate: '<string>'},
endpoint: '<string>',
simpleSearchParams: {}
},
vertexAiSearch: {
dataStoreSpecs: [{dataStore: '<string>', filter: '<string>'}],
datastore: '<string>',
engine: '<string>',
filter: '<string>',
maxResults: 123
},
vertexRagStore: {
ragCorpora: ['<string>'],
ragResources: [{ragCorpus: '<string>', ragFileIds: ['<string>']}],
ragRetrievalConfig: {
filter: {
metadataFilter: '<string>',
vectorDistanceThreshold: 123,
vectorSimilarityThreshold: 123
},
hybridSearch: {alpha: 123},
ranking: {llmRanker: {modelName: '<string>'}, rankService: {modelName: '<string>'}},
topK: 123
},
similarityTopK: 123,
storeContext: true,
vectorDistanceThreshold: 123
}
},
urlContext: {}
}
]
})
};
fetch('https://api.example.com/v1beta/models/{model}:generateContent', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"candidates": [
{
"avgLogprobs": 123,
"citationMetadata": {
"citations": [
{
"endIndex": 123,
"license": "<string>",
"publicationDate": "<string>",
"startIndex": 123,
"title": "<string>",
"uri": "<string>"
}
]
},
"content": {
"parts": [
{
"codeExecutionResult": {
"outcome": "<string>",
"output": "<string>"
},
"executableCode": {
"code": "<string>",
"language": "<string>"
},
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"functionCall": {
"args": {},
"id": "<string>",
"name": "<string>",
"partialArgs": [
{
"boolValue": true,
"jsonPath": "<string>",
"nullValue": "<string>",
"numberValue": 123,
"stringValue": "<string>",
"willContinue": true
}
],
"willContinue": true
},
"functionResponse": {
"id": "<string>",
"name": "<string>",
"parts": [
{
"fileData": {
"displayName": "<string>",
"fileUri": "<string>",
"mimeType": "<string>"
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
}
}
],
"response": {},
"scheduling": "<string>",
"willContinue": true
},
"inlineData": {
"data": "aSDinaTvuI8gbWludGxpZnk=",
"displayName": "<string>",
"mimeType": "<string>"
},
"mediaResolution": {
"level": "<string>",
"numTokens": 123
},
"text": "<string>",
"thought": true,
"thoughtSignature": "aSDinaTvuI8gbWludGxpZnk=",
"videoMetadata": {
"endOffset": 123,
"fps": 123,
"startOffset": 123
}
}
],
"role": "<string>"
},
"finishMessage": "<string>",
"finishReason": "<string>",
"groundingMetadata": {
"googleMapsWidgetContextToken": "<string>",
"groundingChunks": [
{
"maps": {
"placeAnswerSources": {
"flagContentUri": "<string>",
"reviewSnippets": [
{
"authorAttribution": {
"displayName": "<string>",
"photoUri": "<string>",
"uri": "<string>"
},
"flagContentUri": "<string>",
"googleMapsUri": "<string>",
"relativePublishTimeDescription": "<string>",
"review": "<string>",
"reviewId": "<string>",
"title": "<string>"
}
]
},
"placeId": "<string>",
"text": "<string>",
"title": "<string>",
"uri": "<string>"
},
"retrievedContext": {
"documentName": "<string>",
"ragChunk": {
"pageSpan": {
"firstPage": 123,
"lastPage": 123
},
"text": "<string>"
},
"text": "<string>",
"title": "<string>",
"uri": "<string>"
},
"web": {
"domain": "<string>",
"title": "<string>",
"uri": "<string>"
}
}
],
"groundingSupports": [
{
"confidenceScores": [
123
],
"groundingChunkIndices": [
123
],
"segment": {
"endIndex": 123,
"partIndex": 123,
"startIndex": 123,
"text": "<string>"
}
}
],
"retrievalMetadata": {
"googleSearchDynamicRetrievalScore": 123
},
"retrievalQueries": [
"<string>"
],
"searchEntryPoint": {
"renderedContent": "<string>",
"sdkBlob": "aSDinaTvuI8gbWludGxpZnk="
},
"sourceFlaggingUris": [
{
"flagContentUri": "<string>",
"sourceId": "<string>"
}
],
"webSearchQueries": [
"<string>"
]
},
"index": 123,
"logprobsResult": {
"chosenCandidates": [
{
"logProbability": 123,
"token": "<string>",
"tokenId": 123
}
],
"topCandidates": [
{
"candidates": [
{
"logProbability": 123,
"token": "<string>",
"tokenId": 123
}
]
}
]
},
"safetyRatings": [
{
"blocked": true,
"category": "<string>",
"overwrittenThreshold": "<string>",
"probability": "<string>",
"probabilityScore": 123,
"severity": "<string>",
"severityScore": 123
}
],
"tokenCount": 123,
"urlContextMetadata": {
"urlMetadata": [
{
"retrievedUrl": "<string>",
"urlRetrievalStatus": "<string>"
}
]
}
}
],
"createTime": "2023-11-07T05:31:56Z",
"modelVersion": "<string>",
"promptFeedback": {
"blockReason": "<string>",
"blockReasonMessage": "<string>",
"safetyRatings": [
{
"blocked": true,
"category": "<string>",
"overwrittenThreshold": "<string>",
"probability": "<string>",
"probabilityScore": 123,
"severity": "<string>",
"severityScore": 123
}
]
},
"responseId": "<string>",
"sdkHttpResponse": {
"body": "<string>",
"headers": {}
},
"usageMetadata": {
"cacheTokensDetails": [
{
"modality": "<string>",
"tokenCount": 123
}
],
"cachedContentTokenCount": 123,
"candidatesTokenCount": 123,
"candidatesTokensDetails": [
{
"modality": "<string>",
"tokenCount": 123
}
],
"promptTokenCount": 123,
"promptTokensDetails": [
{
"modality": "<string>",
"tokenCount": 123
}
],
"thoughtsTokenCount": 123,
"toolUsePromptTokenCount": 123,
"toolUsePromptTokensDetails": [
{
"modality": "<string>",
"tokenCount": 123
}
],
"totalTokenCount": 123,
"trafficType": "<string>"
}
}Authorizations
Path Parameters
Body
application/json
Show child attributes
Show child attributes
Example:
[
{
"parts": [{ "text": "Explain nordlys routing." }],
"role": "user"
}
]
Show child attributes
Show child attributes
Example:
"gemini-3-pro-preview"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
⌘I

