ToRouter 文档调用网关
Gemini 兼容 API
原生 Google Gemini /v1beta 接口 —— generateContent、streamGenerateContent、google-genai SDK。
ToRouter 在 /v1beta 提供原生 Gemini 接口。官方 google-genai SDK 和 Gemini CLI 无需改动即可使用。
Endpoint
| 方法 | 路径 | 用途 |
|---|---|---|
GET | /v1beta/models | 列出可用模型 |
GET | /v1beta/models/{model} | 模型元信息 |
POST | /v1beta/models/{model}:generateContent | 单次生成 |
POST | /v1beta/models/{model}:streamGenerateContent | SSE 流式 |
POST | /v1beta/models/{model}:countTokens | 预估 token |
/v1beta/* 与 /api/v1beta/* 都可用。
鉴权
二选一：
?key=sk-***或请求头：
x-goog-api-key: sk-***Python SDK（google-genai）
from google import genai
client = genai.Client(
api_key="sk-***",
http_options={"base_url": "https://portal.torouter.ai/v1beta"},
)
resp = client.models.generate_content(
model="gemini-3-flash-preview",
contents="天空为什么是蓝色的？",
)
print(resp.text)curl
curl "https://portal.torouter.ai/v1beta/models/gemini-3-flash-preview:generateContent?key=sk-***" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"hi"}]}]}'流式：
curl "https://portal.torouter.ai/v1beta/models/gemini-3-flash-preview:streamGenerateContent?alt=sse&key=sk-***" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"数到 5"}]}]}'Gemini 接口对 generationConfig、safetySettings、tools、systemInstruction 全部原样透传。