API 参考
Gemini 原生接口
使用 generateContent 和原生内容结构调用支持 Gemini 协议的模型。
配置与调用
确认线路提供 Gemini 原生协议,按 API 概览设置 IROUTER_API_KEY。将路径里的 <model-id> 替换为目录中该接口要求的模型路径标识,不要重复加入 models/。
curl --fail-with-body 'https://gateway.irouter.io/v1beta/models/<model-id>:generateContent' \
-H "x-goog-api-key: $IROUTER_API_KEY" \
-H 'Content-Type: application/json' \
--data '{"contents":[{"role":"user","parts":[{"text":"Reply with a short greeting."}]}]}'原生接口使用 contents 和 parts,不是 messages。该地址使用 /v1beta,不是 OpenAI SDK 的 /v1。
读取返回
文本位于 candidates 中各候选项的 content.parts 文本部分。检查结束原因和安全反馈;没有文本候选时不要把它当作空的成功回答。用量信息通常在 usageMetadata。
流式与边界
流式调用使用同一模型路径下的 :streamGenerateContent?alt=sse,并按 SSE 事件解析返回。密钥仍放在 x-goog-api-key 请求头中。
:countTokens 在本文对应的网关版本未实现。模型出现在统一目录中也不能证明它支持原生协议。收到 404 或模型错误时,核对模型路径、线路和协议,再参考错误排查。
原生字段参考 Google generateContent。