跳转到主要内容
POST
/
gemini-3.1-pro
/
v1
/
chat
/
completions
聊天完成
curl --request POST \
  --url 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": "这张图片里有什么？"
        },
        {
          "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"
}
'
{
  "id": "chatcmpl-example-123",
  "object": "chat.completion",
  "created": 1741569952,
  "model": "gemini-3.1-pro",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好，有什么可以帮你的吗？",
        "refusal": null,
        "annotations": []
      },
      "logprobs": null,
      "finish_reason": "stop"
    }
  ],
  "service_tier": "default"
}

​
流式响应支持

当请求中设置 stream: true 时，API 将以服务器发送事件（SSE）的形式返回响应，Content-Type 为 text/event-stream。这允许渐进式响应交付，消息增量会在生成时逐步发送。每个事件包含部分消息内容，使您能够在应用程序中实时显示响应。 流式响应格式：
  • Content-Type: text/event-stream
  • 每个事件行以 data: 开头，后跟 JSON
  • 事件包含增量消息增量
  • 最终事件通过 finish_reason 指示完成

多模态

支持文本和图像输入

实时搜索

启用 Google 搜索增强

流式传输

支持服务器发送事件

灵活角色

支持多种消息角色

​
Google Search 参数

通过 tools 参数启用 Google 搜索增强，实现实时信息检索： 
{
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "googleSearch"
      }
    }
  ]
}

​
统一媒体文件格式

在 messages 参数的 content 数组中，无论是图像、视频、音频还是其他文档类型，所有媒体文件都使用相同的格式结构：
  • type 字段始终为 "image_url"
  • image_url 字段名称保持不变
  • 唯一变化的是 url 值，它指向相应的媒体文件地址
例如：图像、视频、音频、PDF 和其他文档都使用相同的 { type: 'image_url', image_url: { url: '...' } } 结构。
{
  "id": "chatcmpl-example-123",
  "object": "chat.completion",
  "created": 1741569952,
  "model": "gemini-3.1-pro",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好，有什么可以帮你的吗？",
        "refusal": null,
        "annotations": []
      },
      "logprobs": null,
      "finish_reason": "stop"
    }
  ],
  "service_tier": "default"
}

授权

​
Authorization
string
header
必填

所有 API 都需要通过 Bearer Token 进行身份验证。

获取 API Key：

  1. 访问 API Key 管理页面 获取您的 API Key

使用方法： 添加到请求头： Authorization: Bearer YOUR_API_KEY

注意：

  • 请妥善保管您的 API Key，不要与他人分享
  • 如果您怀疑 API Key 已泄露，请立即在管理页面重置

请求体

application/json
​
messages
object[]
必填

消息对象数组。每个消息都有一个角色和内容。

统一媒体文件格式：

在 content 数组中，无论是图像、视频、音频还是其他文档类型，所有媒体文件都使用相同的格式结构：

  • type 字段始终为 "image_url"
  • image_url 字段名称保持不变
  • 唯一变化的是 url 值，它指向相应的媒体文件地址

例如：图像、视频、音频、PDF 和其他文档都使用相同的 { type: 'image_url', image_url: { url: '...' } } 结构。

Minimum array length: 1
​
stream
boolean
默认值:true

如果设置为 true，将作为服务器发送事件发送部分消息增量。默认为 true。

​
tools
object[]

可选，模型可调用的工具数组。启用 Google 搜索增强时使用：[{"type": "function", "function": {"name": "googleSearch"}}] - 通过 Google 搜索实现实时信息检索。当需要最新资讯、新闻或时事信息时，请在请求中包含此工具。

​
include_thoughts
boolean
默认值:true

是否包含思考过程。如果设置为 true，思考将会被包含在响应结果中，否则将不会出现在响应结果中。默认为 true。

​
reasoning_effort
enum<string>
默认值:high

推理的力度。低力度响应更快，高力度响应更慢但解决更复杂的问题。默认为 "high"。

可用选项:
low,
high

响应

请求成功。返回标准的聊天完成格式。

​
id
string

聊天完成的唯一标识符

示例:

"chatcmpl-example-123"

​
object
string

对象类型

示例:

"chat.completion"

​
created
integer<int64>

完成创建时的 Unix 时间戳

示例:

1677652288

​
model
string

模型名称

示例:

"gemini-3.1-pro"

​
choices
object[]

完成选项数组

​
usage
object