Gemini API：
实时价格，Google 原生格式

1. 创建密钥

   注册并充值（最低 $5），然后在 API 密钥页面创建密钥。无人值守运行的密钥请设置消费上限。

2. 把 Gen AI SDK 指向 Lovely Router

   把 https://lovelyrouter.com 作为 SDK 的 base URL 传入。密钥放在 SDK 会发送的 x-goog-api-key 中；?key= 和 Authorization: Bearer 也可以使用。

3. 调用 generateContent

   generateContent、streamGenerateContent 和 countTokens 的行为与 Google 文档所述一致。

   cURLPythonNode.js

   Shell

   curl "https://lovelyrouter.com/v1beta/models/gemini-3.1-pro:generateContent" \
     -H "x-goog-api-key: $LOVELY_API_KEY" \
     -H "content-type: application/json" \
     -d '{
       "contents": [{"role": "user", "parts": [{"text": "Explain DNS in two sentences."}]}]
     }'

以上价格单位为美元/百万 token，取自实时目录。模型 ID 以 GET /v1/models 为准，例如 gemini-3.1-pro 和 gemini-3-flash；Google 的写法，如 gemini-3.1-pro-preview 或 models/gemini-3-flash，会解析到同一个模型。GET /v1beta/models 以 Gemini 自己的响应格式列出这种格式下可用的所有模型。Gemini 模型由 gemini-value 渠道组提供服务；模型广场显示实时可用性，状态页按小时显示每个渠道组的可用性。

以下 Gemini 端点不提供：cachedContents（显式上下文缓存）、文件上传、embedContent 和 batchEmbedContents、批处理模式以及 Live API。

Gemini 模型也支持 OpenAI Chat Completions 和 Anthropic Messages，当你的应用只支持其中一种格式时很有用。thinkingConfig 等 Gemini 专属选项只能保证在原生格式中生效。

Gemini CLI 从环境变量读取端点和密钥：

export GOOGLE_GEMINI_BASE_URL=https://lovelyrouter.com
export GEMINI_API_KEY=$LOVELY_API_KEY
gemini -m gemini-3.1-pro

在你的工具中使用介绍了其他客户端，AI 编程智能体则展示了如何用同一个密钥同时运行 Gemini CLI、Claude Code 和 Codex CLI。

Gemini 会自行缓存重复的提示词前缀，无需任何标记。缓存的 token 显示在 usageMetadata.cachedContentTokenCount 中，按缓存读取价格计费，没有缓存写入费用。

只有下一轮请求到达持有缓存的渠道，缓存才能发挥作用。Lovely Router 根据系统提示词和第一条用户消息为每个对话生成指纹，并把后续各轮请求送回同一个渠道。如果你的应用会改写或总结旧的历史记录，请改为每个对话发送一个固定的 x-session-id 请求头。系统指令中的时间戳会同时破坏指纹和 Gemini 自身的缓存，所以请把它放到最新的用户消息里。详见提示缓存。

原本需要你自己处理的失败，网关会先替你重试。在某个渠道上失败的请求，会在同一渠道组内的另一个渠道上重试，最多尝试三次；流在首个 token 到达前会被暂缓，因此在此之前发生的失败会被重试，而不会传到你这里。剩下的错误以 Gemini 的错误格式返回：429 对应 RESOURCE_EXHAUSTED，502 对应 UNAVAILABLE。请以退避方式重试这些错误，并在响应带有 retry-after 时遵循它。无效请求（400、404、413、422）不会重试，因为换到别处也会以同样的方式失败。

建议使用 alt=sse。不加它时，streamGenerateContent 返回一个 JSON 数组；加上它，停滞三分钟的流会以一个明确的 DEADLINE_EXCEEDED 错误事件结束，便于你检测。完整的对照表见限流与故障转移。

Gemini 按 token 计费。未缓存输入为 promptTokenCount 减去 cachedContentTokenCount；缓存 token 按缓存读取价格计费；输出为 candidatesTokenCount 加上 thoughtsTokenCount，按输出价格计费。目前所有渠道组都按官方标价计费，因此每个 Gemini 模型的价格与 Google 公布的一致。费用会在响应返回后几秒内从你的预付费余额中扣除。

没有订阅，也没有月费。在到达模型之前就被拒绝的请求不收费，重试的尝试不计费，你取消的流只为已生成的内容付费。价格页在一页中列出了所有产品。