协议

兼容 Gemini 的 API

Gemini 客户端调用 /v1beta/models/{model}:generateContent。RelayRouter 在自己的域名上提供同样的路径，所以 Google GenAI SDK、Gemini CLI 和手写的 HTTP 调用只要改 base URL 和密钥就能用。流式用 streamGenerateContent，与 Google 原生一致。

Base URL 与端点

https://relayrouter.io SDK 会自己拼接 /v1beta；手写 HTTP 时用 https://relayrouter.io/v1beta/models/{model}:generateContent。

方法	路径	说明
POST	/v1beta/models/{model}:generateContent	单次响应
POST	/v1beta/models/{model}:streamGenerateContent	流式，加 ?alt=sse 得到 server-sent events
GET	/v1/models	你的密钥可调用的模型列表

鉴权： x-goog-api-key: <你的 RelayRouter 密钥>，或与 Google 一样使用 key 查询参数。

代码

Python

main.pypython

from google import genai
from google.genai import types

client = genai.Client(
    api_key="your-relayrouter-key",
    http_options=types.HttpOptions(base_url="https://relayrouter.io"),
)

resp = client.models.generate_content(model="gemini-3.8-flash", contents="Hello!")
print(resp.text)

cURL

terminalbash

curl "https://relayrouter.io/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: $RELAYROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents": [{"parts": [{"text": "Hello!"}]}]}'

Gemini CLI

terminalbash

export GOOGLE_GEMINI_BASE_URL="https://relayrouter.io"
export GEMINI_API_KEY="your-relayrouter-key"
gemini

使用这一协议的分组

一把密钥属于一个分组。在控制台为下面任一分组创建密钥；模型页有全部分组与模型的实时费率。

分组	费率	模型（示例）
Gemini 快速	每 $1 标准用量 ¥2.72，约低于 ¥6.8/$ 参考价 60%	gemini-2.5-flash, gemini-3-flash, gemini-3-flash-preview, gemini-3.1-flash-lite, gemini-3.1-flash-lite-preview 等共 9 个
Gemini Vertex 官方	每 $1 标准用量 ¥5.4，约低于 ¥6.8/$ 参考价 21%	gemini-2.0-flash, gemini-2.5-computer-use-preview-10-2025, gemini-2.5-flash, gemini-2.5-flash-image, gemini-2.5-flash-image-preview 等共 30 个

可直接使用的工具

Google GenAI SDK (Python, TypeScript, Go): http_options.base_url=https://relayrouter.io
Gemini CLI: GOOGLE_GEMINI_BASE_URL 与 GEMINI_API_KEY
Any HTTP client: POST 到 /v1beta/models/{model}:generateContent

常见问题

有哪些 Gemini 模型？

gemini-3.8-flash、gemini-3.7-flash 以及模型页 Gemini 分组里列出的其他模型。每个分组有自己的费率。

能改用兼容 OpenAI 的端点调用 Gemini 模型吗？

按密钥所属分组的协议调用。Gemini 分组使用 Gemini API；如果你的工具只会 OpenAI 协议，请在模型页选择 OpenAI 协议的分组。

支持流式吗？

支持，通过 streamGenerateContent 加 ?alt=sse，与 Google 原生一致。

怎么计费？

按分组费率从预付余额按 token 扣除，无平台费，失败请求不计费。

其他协议

指南