Gemini 原生格式
适用于已使用 Google Gemini 原生 SDK 的应用。模型名称位于 URL 路径中,请使用当前 API Key 可见的模型名称替换示例中的模型部分。请求鉴权
正式接口
https://your-domain/v1beta/models/gemini-3.1-pro-preview:generateContent。
请求参数
调用示例
成功响应
candidates[].content.parts[] 并读取 text。用量从 usageMetadata 读取,常用字段为 promptTokenCount、candidatesTokenCount 与 totalTokenCount。
注意事项
- Gemini 将模型名称放在路径中,不在 JSON 请求体中传递
model。 - 使用
x-goog-api-key,不要将 OpenAI 的Authorization: Bearer请求头混入此协议。 - 本页仅承诺已验证的纯文本
generateContent调用,不承诺图像或文件输入、grounding、function calling 或 Gemini 原生流式端点。