ToRouter 文档集成指南
Google Gen AI SDK（Gemini）
通过 ToRouter 原生 /v1beta 接口调用 Gemini 2.5 与 Google Gen AI 全系模型。
ToRouter 在 https://portal.torouter.ai/v1beta 暴露原生 Gemini v1beta API。新版 google-genai SDK 与旧版 google-generativeai 包均可使用——只需替换 Base URL 与 API Key。
配置
| 配置项 | 说明 |
|---|---|
| Base URL | https://portal.torouter.ai/v1beta |
| API Key | sk-*** |
| 模型 | gemini-2.5-pro、gemini-2.5-flash、gemini-2.5-flash-lite 等 |
鉴权支持查询参数 ?key=sk-*** 或请求头 x-goog-api-key: sk-***，SDK 默认使用请求头形式。
代码
from google import genai
client = genai.Client(
api_key="sk-***",
http_options={"base_url": "https://portal.torouter.ai"},
)
resp = client.models.generate_content(
model="gemini-2.5-pro",
contents="Hello",
)
print(resp.text)import google.generativeai as genai
genai.configure(
api_key="sk-***",
client_options={"api_endpoint": "portal.torouter.ai"},
transport="rest",
)
model = genai.GenerativeModel("gemini-2.5-pro")
print(model.generate_content("Hello").text)curl "https://portal.torouter.ai/v1beta/models/gemini-2.5-pro:generateContent" \
-H "x-goog-api-key: sk-***" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"Hello"}]}]}'易踩的坑
google-genai的http_options.base_url应填主机根路径（https://portal.torouter.ai），SDK 会自动追加/v1beta/...。旧版 SDK 的api_endpoint只接收主机名。- 流式调用使用
models.generate_content_stream(...)（新版）或stream=True（旧版），均使用同一 Base URL。 - 一些 Gemini 独有特性（Files API、
text-embedding-004嵌入、grounding）按透传方式工作；单个模型是否可用取决于 Key 解析到的渠道。