你将构建什么
你将发送一个原生 GeminiPOST /v1beta/models/\{model\}:generateContent 请求,然后将其与兼容 OpenAI 的 POST /v1/chat/completions 选项进行比较,适用于已使用聊天补全请求结构的应用。
前提条件
- 一个存储在
COMETAPI_KEY中的 CometAPI API key - 一个来自模型页面的 Gemini 文本 model ID
curl、Python 3.10+ 或 Node.js 18+
API key、base URL、身份验证
当你想使用 Gemini 请求字段时,请使用 Gemini 原生端点:x-goog-api-key:
原生 Gemini 格式
原生 Gemini 请求使用contents、parts 和 generationConfig。当你需要 Gemini 特有字段时,请使用此路径,例如 thinking 控制、媒体 parts、Google Search grounding 或原生流式操作符。
OpenAI 兼容选项
当你正在迁移现有的 OpenAI SDK 或聊天补全应用,且不需要 Gemini 原生请求字段时,请使用兼容 OpenAI 的路径。流程说明
不要混用这两种请求格式。像
contents 和 generationConfig 这样的原生 Gemini 字段应当用于 generateContent 路径。像 messages 这样的聊天补全字段应当用于兼容 OpenAI 的路径。
故障排查 / FAQ
我应该从哪个路径开始
我应该从哪个路径开始
如果你正在构建新的 Gemini 工作流,请从原生 Gemini
generateContent 开始。当现有应用已经依赖 OpenAI SDK 或聊天补全请求结构时,请使用兼容 OpenAI 的路径。原生 Gemini 字段在聊天补全中失败
原生 Gemini 字段在聊天补全中失败
请将
contents、parts、generationConfig 和 streamGenerateContent 请求发送到 Gemini 原生端点。兼容 OpenAI 的路径需要 messages 和聊天补全参数。Gemini model ID 调用失败
Gemini model ID 调用失败
请确认该 model ID 对你的账户可用,并且支持你正在调用的路径。使用模型页面查找当前可用的 model ID。
SDK 指向了错误的服务
SDK 指向了错误的服务
对于 Google GenAI SDK 请求,请将 base URL 设置为
https://api.cometapi.com。对于 OpenAI SDK 请求,请在 Python 中设置 base_url,或在 Node.js 中设置 baseURL 为 https://api.cometapi.com/v1。后续步骤
- 使用 Gemini 原生 API 参考 查看完整的
generateContent请求和响应字段。 - 阅读聊天补全 API 参考了解兼容 OpenAI 的请求结构。
- 在将 CometAPI 与 OpenAI SDK 搭配使用中配置 OpenAI SDK 客户端。
- 通过列出可用的 CometAPI 模型查看可用模型。
- 通过错误代码与重试策略添加重试和限流处理。