Gemini 3.1 Pro (openai)
POST
/gemini-3.1-pro/v1/chat/completions
WARNING
⚠️ 仅支持对话调用
该模型目前仅支持对话调用，暂未适配 Agent 场景。若将其接入 Agent 使用，可能会出现请求报错或结果异常。
流式响应支持
当请求中设置 stream: true 时，API 将以服务器发送事件（SSE）的形式返回响应，Content-Type 为 text/event-stream。这允许渐进式响应交付，消息增量会在生成时逐步发送。每个事件包含部分消息内容，使您能够在应用程序中实时显示响应。
流式响应格式：
- Content-Type:
text/event-stream - 每个事件行以
data:开头，后跟 JSON - 事件包含增量消息增量
- 最终事件通过
finish_reason指示完成 - 流的最后一块带 usage 与 credits_consumed，随后是 data: [DONE]。
统一媒体文件格式
WARNING
在 messages 参数的 content 数组中，无论是图像、视频、音频还是其他文档类型，所有媒体文件都使用相同的格式结构：
type字段始终为"image_url"image_url字段名称保持不变- 唯一变化的是
url值，它指向相应的媒体文件地址
例如：图像、视频、音频、PDF 和其他文档都使用相同的 { type: 'image_url', image_url: { url: '...' } } 结构。
Tools 参数
tools 参数是一个可选数组，允许您定义模型可以调用的函数。数组可以包含多个对象。使用函数调用时，可以在数组中定义多个函数。
{
"type": "function",
"function": {
"name": "googleSearch"
}
}
这将通过 Google 搜索启用实时信息检索。
错误响应
错误以 HTTP 200 返回，响应体为 {"code": , "msg": "<原因>"}。读取 choices/candidates 前请先判断 code（200 为成功）。
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": 0.27,
"id": "chatcmpl-********************z6IaTP6H",
"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
}
}