Gemini 原生格式

适用于已使用 Google Gemini 原生 SDK 的应用。模型名称位于 URL 路径中,请使用当前 API Key 可见的模型名称替换示例中的模型部分。

请求鉴权

正式接口

完整地址示例:https://your-domain/v1beta/models/gemini-3.1-pro-preview:generateContent

请求参数

调用示例

成功响应

遍历 candidates[].content.parts[] 并读取 text。用量从 usageMetadata 读取,常用字段为 promptTokenCountcandidatesTokenCounttotalTokenCount

注意事项

  1. Gemini 将模型名称放在路径中,不在 JSON 请求体中传递 model
  2. 使用 x-goog-api-key,不要将 OpenAI 的 Authorization: Bearer 请求头混入此协议。
  3. 本页仅承诺已验证的纯文本 generateContent 调用,不承诺图像或文件输入、grounding、function calling 或 Gemini 原生流式端点。