gemini-3.1-pro-preview API 文档

Google gemini-3.1-pro-preview · Chat 模型。Model ID: gemini-3.1-pro-preview，Gemini 3.1 Pro 预览版，3 系列稳定性增强迭代。

ChatGoogle6 家上游

Gemini 3.1 Pro 预览版，3 系列稳定性增强迭代。

在 kukuai.fyi 获取 API Key 快速开始

Gemini 3.1 Pro Preview 可以理解为 3 系列 Pro 方向的迭代版本，侧重稳定性与质量延续。
如果你在比较同系列预览版差异，它适合作为 Google 多模态高阶路线的一个候选。

适用场景

多模态推理、长文档分析、研究综述
希望在 Google 系列里比较不同 Pro 迭代版本
对图像理解与推理质量有较高要求时

接入说明

接入方式与其他 OpenAI 兼容模型一致，不需要为了小版本迭代重做接口。
建议在你已有提示词集上做 A/B 对比，而不是凭名称直接切生产默认值。

使用提醒

preview / 小版本迭代的可用性和能力边界以控制台为准。
如果你的首要目标是速度，Flash 版本通常更合适。

能力标签

长上下文视觉理解function calling高质量推理

接口路径

POST https://www.kukuai.fyi/api-proxy/china/v1/chat/completions

该路径由模型分类决定：Chat / Image / Video / Audio 使用不同 endpoint，同一分类内通常只需要替换 model 字段。Chat 模型还要区分 OpenAI 兼容协议与 Anthropic / Claude 协议。

请求需在 Header 中携带 Authorization: Bearer <API_KEY>。完整字段说明见 Chat Completions API。

API 文档

项目	值
Endpoint	POST /v1/chat/completions
Model ID	`gemini-3.1-pro-preview`
Content-Type	application/json
接口类型	OpenAI 兼容对话补全接口，支持非流式和流式输出
Base URL	OpenAI 兼容工具用 https://www.kukuai.fyi/api-proxy/china/v1；Claude 风格工具如支持该模型则用根地址。

Headers / 鉴权

字段	类型	必填	说明
`Authorization`	string	必填	使用 `Bearer <KUKUAI_API_KEY>`。API Key 在 kukuai.fyi 控制台创建。
`Content-Type`	string	必填	请求体格式。音频转写上传文件时使用 `multipart/form-data`。默认值：`application/json`
`Accept`	string	可选	非流式接口返回 JSON；Chat 流式请求会返回 SSE 数据流。默认值：`application/json 或 text/event-stream`

Chat 协议差异

Chat 模型不只看模型名，还要看你使用的客户端协议。 Claude Code / Anthropic SDK 和 OpenAI SDK 拼出来的路径不同。

协议	Base URL	Endpoint	Body
OpenAI 兼容推荐	`https://www.kukuai.fyi/api-proxy/china/v1`	`POST /v1/chat/completions`	`{ "model": "gemini-3.1-pro-preview", "messages": [...] }`
Anthropic / Claude	`https://www.kukuai.fyi/api-proxy/china`	`POST /v1/messages`	`{ "model": "gemini-3.1-pro-preview", "messages": [...] }`

这个模型更适合优先走 OpenAI 兼容协议；只有当目标工具明确支持 Claude 风格接入时，才使用 Anthropic 路径。

请求参数

以下字段按当前模型分类生成。价格、上下文长度、限速、可用线路等动态信息以 kukuai.fyi 控制台为准。

字段	类型	必填	说明
`model`	string	必填	当前模型 ID：`gemini-3.1-pro-preview`。复制时请保持大小写一致。
`messages`	`array<Message>`	必填	多轮对话历史。每条消息包含 `role` 和 `content`。
`stream`	boolean	可选	是否使用 SSE 流式返回。适合聊天界面和长回答。默认值：`false`
`temperature`	number	可选	采样温度，值越高越发散。正式业务建议先固定后再调优。默认值：`1`
`max_tokens`	integer	可选	本次生成的最大 token 数。模型上下文边界以控制台为准。
`response_format`	object	可选	结构化输出配置，例如 `{ "type": "json_object" }`。
`tools`	`array<Tool>`	可选	Function calling 工具定义。是否支持取决于具体模型和账号配置。

响应字段

响应结构保持 OpenAI 兼容风格；媒体类模型可能返回异步任务 ID 或资源 URL。

字段	类型	必填	说明
`id`	string	必填	本次补全的唯一 ID，便于排障关联日志。
`object`	string	必填	固定为 `chat.completion` 或流式 chunk 类型。
`model`	string	必填	实际承担推理的模型 ID。
`choices`	`array<Choice>`	必填	生成结果数组，包含 `message`、`delta` 或 `finish_reason`。
`usage`	object	可选	Token 用量统计。流式请求可能在结束包或非流式响应中返回。

状态码

状态码	类型	必填	说明
`200`	OK	必填	请求成功，响应体结构见上方响应字段。
`400`	Bad Request	可选	请求字段不合法，例如缺少必填字段、图片尺寸格式错误或文件格式不支持。
`401`	Unauthorized	可选	API Key 缺失、无效或格式错误。
`404`	Not Found	可选	Endpoint 或模型不存在。请确认路径为 `/v1/chat/completions`，模型 ID 为 `gemini-3.1-pro-preview`。
`429`	Rate Limited	可选	触发限速、并发限制或余额不足。控制台会展示当前账号可用额度。
`5xx`	Upstream Error	可选	上游或线路异常。可切换等价线路重试，并保留请求 ID 便于排查。

错误与排查

401：检查 Authorization 是否为 Bearer <API_KEY>，以及 Key 是否仍有效。
404：检查 endpoint 是否为 /v1/chat/completions，以及模型名 gemini-3.1-pro-preview 是否在控制台可见。
429：触发限速或余额不足时，降低并发、缩短请求，或到控制台查看额度。
5xx：优先切换等价线路重试，并记录请求 ID 方便排障。

请求示例

curl https://www.kukuai.fyi/api-proxy/china/v1/chat/completions \
  -H "Authorization: Bearer $KUKUAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-pro-preview",
    "messages": [
      {"role": "user", "content": "用一句话介绍 kukuai.fyi"}
    ]
  }'

期望响应（精简示例）：

json

{
  "id": "chatcmpl-gemini-3",
  "object": "chat.completion",
  "created": 1730000000,
  "model": "gemini-3.1-pro-preview",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": { "role": "assistant", "content": "..." }
    }
  ],
  "usage": { "prompt_tokens": 24, "completion_tokens": 64, "total_tokens": 88 }
}

gemini-3.1-pro-preview API 文档 ​

适用场景 ​

接入说明 ​

使用提醒 ​

能力标签 ​

推荐场景 ​

接口路径 ​

API 文档 ​

Headers / 鉴权 ​

Chat 协议差异 ​

请求参数 ​

响应字段 ​

状态码 ​

错误与排查 ​

请求示例 ​