メインコンテンツへスキップ
OrcaRouter の /v1beta/ インターフェースは Google の Gemini API への 直接パススルーです。OpenAI 形式に収まらない Gemini 機能 (インラインの 音声/動画データ、googleSearch などのネイティブ内蔵ツール、完全な generationConfig.thinkingConfig)、あるいは単にすでに google-genai SDK を使っているときに、このパスを選んでください。 通常のチャットなら OpenAI 互換パス (POST /v1/chat/completions に model=google/...) のほうが通常 シンプルで、プロバイダ間で同じ書き方ができます——SDK 設定は 互換性 / Google GenAI SDK を 参照してください。

​
パス構成

POST https://api.orcarouter.ai/v1beta/models/{model}:{action}
認識される action:
Action動作
:generateContent1 回限りの応答 (JSON)
:streamGenerateContent部分的チャンクの SSE ストリーム
その他の Gemini アクション (countTokens、tunedModels.* など) は 今のところこのインターフェースを通りません。

​
認証

このインターフェースは 3 種類のヘッダ形式を受け付けるので、公式の google-genai SDK はヘッダの加工なしに動作します:
  • Authorization: Bearer sk-orca-...
  • x-goog-api-key: sk-orca-...
  • ?key=sk-orca-... (クエリ文字列。ヘッダ設定をサポートしないツール 向けの最後の手段)

​
例

curl "https://api.orcarouter.ai/v1beta/models/google/gemini-2.5-flash:generateContent" \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "Write a one-sentence haiku about the sea."}]}]
  }'

​
内蔵ツール

Gemini の 3 種類のネイティブ内蔵ツールは Google のドキュメント通りに 動作します——リクエストボディの tools 配列に渡してください:
ツール効果
{"googleSearch": {}}ウェブグラウンディング。レスポンスには groundingMetadata が付きます。OrcaRouter は課金用に webSearchQueries を捕捉します。
{"codeExecution": {}}モデルにサンドボックス Python を実行させる。
{"urlContext": {}}モデルがプロンプトで言及した URL を取得・要約する。
同じ 3 種類のツールは、予約された関数名を介して OpenAI 形式の Chat Completions からも到達できます—— 高度な機能 / ウェブ検索 と 高度な機能 / ツール呼び出し を参照 してください。

​
関連項目