Gemini Chat

Gemini 文字模型通过 OpenAI 兼容的 Chat Completions 接口调用。客户端只需要请求 Cubicspaces 的 /v1/chat/completions。

请求地址

POST /v1/chat/completions

支持模型

模型
gemini-3.1-flash-lite
gemini-3-flash-preview
gemini-3.1-pro-preview

实际可用模型以账户权限和平台配置为准。

请求示例

curl https://cubicspaces.cloud/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-lite",
    "messages": [
      { "role": "user", "content": "用一句话介绍 Gemini。" }
    ],
    "temperature": 0.2,
    "stream": false
  }'

返回格式

返回遵循 OpenAI Chat Completions 格式，文本内容读取：

choices[0].message.content

流式输出

curl https://cubicspaces.cloud/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-pro-preview",
    "messages": [
      { "role": "user", "content": "写一段简短的产品文案。" }
    ],
    "stream": true
  }'

流式响应遵循 OpenAI SSE 格式。每个 data: 块中读取 choices[0].delta.content。

注意事项

• 普通对外调用只使用 /v1/chat/completions。
• 请求体使用 OpenAI Chat Completions 标准字段，例如 model、messages、temperature、stream。
• 不要在这个接口中传 Gemini 原生 contents、generationConfig 或 safetySettings。