Skip to main content

你将构建什么

你将发送一个原生 Gemini POST /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 原生端点:
对于直接的原生 Gemini HTTP 请求,使用 x-goog-api-key
仅当你的应用已经使用聊天补全时,才使用兼容 OpenAI 的 base URL:

原生 Gemini 格式

原生 Gemini 请求使用 contentspartsgenerationConfig。当你需要 Gemini 特有字段时,请使用此路径,例如 thinking 控制、媒体 parts、Google Search grounding 或原生流式操作符。

OpenAI 兼容选项

当你正在迁移现有的 OpenAI SDK 或聊天补全应用,且不需要 Gemini 原生请求字段时,请使用兼容 OpenAI 的路径。

流程说明

不要混用这两种请求格式。像 contentsgenerationConfig 这样的原生 Gemini 字段应当用于 generateContent 路径。像 messages 这样的聊天补全字段应当用于兼容 OpenAI 的路径。

故障排查 / FAQ

如果你正在构建新的 Gemini 工作流,请从原生 Gemini generateContent 开始。当现有应用已经依赖 OpenAI SDK 或聊天补全请求结构时,请使用兼容 OpenAI 的路径。
请将 contentspartsgenerationConfigstreamGenerateContent 请求发送到 Gemini 原生端点。兼容 OpenAI 的路径需要 messages 和聊天补全参数。
请确认该 model ID 对你的账户可用,并且支持你正在调用的路径。使用模型页面查找当前可用的 model ID。
对于 Google GenAI SDK 请求,请将 base URL 设置为 https://api.cometapi.com。对于 OpenAI SDK 请求,请在 Python 中设置 base_url,或在 Node.js 中设置 baseURLhttps://api.cometapi.com/v1

后续步骤