ToRouterドキュメントゲートウェイ
Gemini 互換 API
ネイティブな Google Gemini /v1beta サーフェス — generateContent、streamGenerateContent、google-genai SDK 対応。
ToRouter は /v1beta にネイティブな Gemini サーフェスをマウントしています。公式の google-genai SDK と Gemini CLI は無修正で動作します。
エンドポイント
| メソッド | パス | 用途 |
|---|---|---|
GET | /v1beta/models | 利用可能なモデル一覧 |
GET | /v1beta/models/{model} | モデルのメタデータ |
POST | /v1beta/models/{model}:generateContent | 単発生成 |
POST | /v1beta/models/{model}:streamGenerateContent | SSE ストリーミング |
POST | /v1beta/models/{model}:countTokens | トークン数カウント |
/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="Why is the sky blue?",
)
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":"count to 5"}]}]}'Gemini サーフェスは generationConfig、safetySettings、tools、systemInstruction を無変更で転送します。