Gemini 模型 | API 文档

Gemini 模型通过通用 Chat Completions 接口调用。本文记录当前支持的 model 值和文本对话合同。

text

POST https://api.requestbeam.com/v1/chat-completions

可用模型

`model` 值	非流式 JSON	SSE 流式
`gemini-3.6-flash`	支持	支持
`gemini-3.7-flash`	支持	支持
`gemini-3.8-flash`	支持	支持
`gemini-3.5-flash-lite`	支持	支持

型号名称只用于区分产品层级，不构成延迟、吞吐量或质量 SLA。请用真实工作负载比较模型。请求前请通过 GET https://api.requestbeam.com/v1/models 确认当前 API Key 的可用范围。

验证

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

非流式请求

json

{
  "model": "gemini-3.7-flash",
  "messages": [
    {
      "role": "system",
      "content": "你是一名简洁、准确的技术助手。"
    },
    {
      "role": "user",
      "content": "用五句话解释什么是幂等 API。"
    }
  ],
  "stream": false
}

流式请求

json

{
  "model": "gemini-3.6-flash",
  "messages": [
    {
      "role": "user",
      "content": "给出一个 TypeScript API 错误处理示例。"
    }
  ],
  "stream": true
}

本接口默认返回完整 JSON。需要 SSE 流式输出时必须显式设置 stream: true。

请求字段

modelstring必填

使用 gemini-3.6-flash、gemini-3.7-flash、gemini-3.8-flash 或 gemini-3.5-flash-lite。

messagesobject[]必填

OpenAI Chat Completions 风格的消息数组。每条消息包含 role 和 content。

streamboolean默认: false

true 返回 SSE，false 返回完整 JSON。

max_tokensinteger

可选的最大输出 token 数，使用正整数。省略时使用所选模型的上游默认额度。不同模型的额度可能同时包含推理 token 和最终正文；较小额度可能导致回答截断，或在生成正文前耗尽。提高额度可能增加费用。

max_completion_tokensinteger

max_tokens 的可选兼容字段，适用相同的额度注意事项。具体支持情况由所选模型判断；省略这两个字段时使用上游默认额度。

temperature、top_p、frequency_penalty、presence_penalty、stop 和 n 等通用字段见通用对话接口。可选字段的支持情况和行为取决于所选模型；本页不保证所有通用字段都受支持。

成功响应

json

{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "created": 1787200000,
  "model": "gemini-3.7-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "幂等 API 的核心是同一请求重复执行不会产生额外副作用..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 26,
    "completion_tokens": 118,
    "total_tokens": 144
  }
}

usage 可能包含推理 token 等额外明细；客户端应把这些字段视为可选信息。

使用建议

请求体的 model 必须填写本页“可用模型”表中列出的公开模型 ID。
不接受 Gemini 产品名、显示名称或其他别名代替公开模型 ID。
本页仅适用于 POST https://api.requestbeam.com/v1/chat-completions 的 Chat Completions 请求，不适用于

OpenAI Responses 或 Claude Messages。

可用范围和实时价格以当前 API Key 的 GET https://api.requestbeam.com/v1/models 返回结果及控制台为准。