Gemini 3.1 Pro (openai)
POST
/gemini-3.1-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.Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.kie.ai/gemini-3.1-pro/v1/chat/completions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"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 Response Example
200 - Example 1
{
"choices": [
{
"finish_reason": "stop",
"index": 0,
"message": {
"content": "Hello! How can I help you today?",
"role": "assistant"
}
}
],
"created": 1768283309,
"credits_consumed": 27,
"id": "chatcmpl-********************z6IaTP6H",
"model": "gemini-3.1-pro",
"object": "chat.completion",
"usage": {
"completion_tokens": 383,
"completion_tokens_details": {
"audio_tokens": 0,
"text_tokens": 0,
"reasoning_tokens": 374
},
"prompt_tokens": 1,
"total_tokens": 384
}
}