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 キーだけです。
設定
| 項目 | 値 |
|---|---|
| Base URL | https://portal.torouter.ai/v1beta |
| API キー | 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でホスト名のみを受け取ります。- ストリーミングは新しい SDK では
models.generate_content_stream(...)、従来 SDK ではstream=Trueを使います。どちらも同じ Base URL 上で動作します。 - 一部の Gemini 専用機能（Files API、
text-embedding-004でのエンベディング、グラウンディング）はパススルーで提供されます。モデルごとの利用可否は、キーが解決されるチャネルに依存します。