跳轉到主要內容
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含義
:generateContent一次性響應（JSON）
:streamGenerateContentSSE 流式分片
其它 Gemini 操作（countTokens、tunedModels.* 等）目前不通過本接口 路由。

​
鑒權

此接口同時接受三種 header 形式，所以官方 google-genai SDK 無需任何 header 改造即可使用：
  • Authorization: Bearer sk-orca-...
  • x-goog-api-key: sk-orca-...
  • ?key=sk-orca-...（查詢字符串，僅當工具不支持設置 header 時使用）

​
示例

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 的三大原生內置工具按 Google 官方所述工作——在請求體的 tools 數組中傳入即可：
工具效果
{"googleSearch": {}}聯網接地。響應包含 groundingMetadata。OrcaRouter 會捕獲 webSearchQueries 用于計費。
{"codeExecution": {}}允許模型在沙箱里運行 Python。
{"urlContext": {}}允許模型抓取并總結你在提示里提到的 URL。
同樣這三個工具也能在 OpenAI 形態的 Chat Completions 中通過保留函數名 訪問——見高級 / 聯網搜索 與 高級 / 工具調用。

​
另見