Gemini 2.5 Pro
POST
/gemini-2.5-pro/v1/chat/completions
Streaming Support
stream: true is set in the request, the API returns responses as server-sent events (SSE) with Content-Type: text/event-stream. This allows for progressive response delivery, where message deltas are sent incrementally as they are generated. Each event contains partial message content, enabling real-time display of responses in your application.text/event-streamdata: followed by JSONfinish_reason⚠️Important: Unified Media Structure
messages array share the exact same JSON structure:- The
typefield is fixed as"image_url" - The
image_urlkey name remains unchanged for all file types - Only the
urlvalue points to your specific media file
// Example for Video/Audio/PDF/Image:
{ "type": "image_url", "image_url": { "url": "https://..." } }
{ "type": "image_url", "image_url": { "url": "https://..." } }
Tools Parameter
tools parameter is an optional array that allows you to define functions the model can call. The array can contain multiple objects. When using function calling, you can define multiple functions in the array.RESTRICTION
Conflict WarningGoogle SearchXOR
Function CallingResponse Format Parameter
response_format parameter is an optional JSON Schema object that defines the structure of the response. When provided, the model will generate responses that conform to this schema.PARAMETER CONFLICT
Incompatible Configurationresponse_format parameter and Function Calling (tools) are mutually exclusive.- Use
response_formatfor structured JSON output (e.g., JSON Mode). - Use Function Calling for interacting with external tools and APIs.
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kie.ai/gemini-2.5-pro/v1/chat/completions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "What is in this image?"
},
{
"type": "image_url",
"image_url": {
"url": "https://file.aiquickdraw.com/custom-page/akr/section-images/1759055072437dqlsclj2.png"
}
}
]
}
],
"tools": [
{
"type": "function",
"function": {
"name": "googleSearch"
}
}
],
"stream": true,
"include_thoughts": true,
"reasoning_effort": "high",
"response_format": {
"type": "json_schema",
"json_schema": {
"name": "structured_output",
"strict": true,
"schema": {
"type": "object",
"properties": {
"response": {
"type": "string"
}
}
}
}
}
}'Response Response Example
200 - Example 1
{
"id": "chatcmpl-example-123",
"object": "chat.completion",
"created": 1677652288,
"model": "gemini-2.5-pro",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "string"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 50,
"total_tokens": 60
}
}