Gemini 3.1 Pro Preview 对话

model = gemini-3.1-pro-preview·输入 ¥1.14 · 输出 ¥6.83 · 命中缓存 ¥0.11 / 1M Token

OpenAI 兼容聊天完成接口：POST /api/v1/chat/completions
支持 messages 多轮对话与 stream 流式响应
按实际输入、输出和命中缓存 Token 结算；失败自动退款

POST /api/v1/chat/completions

模型页试一试 →

模型 ID

请求体 model 必须为 gemini-3.1-pro-preview。

计费

按 Token 实际用量结算；页面价格以模型详情中的输入、输出、命中缓存单价为准。

Authorizations

需要 Bearer Token。在 API Key 管理创建后，请求头加入：

Authorization: Bearer sk-你的API_Key

Base URL：https://xiaoguai123.xyz

Body

对话模型 ID

固定填写 gemini-3.1-pro-preview

对话消息列表

至少包含一条 user 消息；每条消息包含 role 与 content

最大输出 Token 数

范围 1–8192；不传时默认 2048

使用场景示例

单轮对话

{
  "model": "gemini-3.1-pro-preview",
  "messages": [
    {
      "role": "user",
      "content": "解释什么是流式响应。"
    }
  ]
}

流式对话

{
  "model": "gemini-3.1-pro-preview",
  "messages": [
    {
      "role": "user",
      "content": "写一段产品介绍。"
    }
  ],
  "stream": true
}

Response

非流式请求返回 choices 和 usage；流式请求以 SSE 增量返回内容。

• 非流式请求返回 choices 与 usage。

• 流式请求通过 SSE 返回增量内容，最后一个事件包含 usage。

REQUEST

curl -X POST https://xiaoguai123.xyz/api/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{ "model": "gemini-3.1-pro-preview", "messages": [ { "role": "user", "content": "用三句话解释什么是流式响应。" } ], "stream": true }'

RESPONSE

对话完成

{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "..." },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 42, "completion_tokens": 68 }
}