跳转到主要内容
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 中通过保留函数名 访问——见高级 / 联网搜索 与 高级 / 工具调用。

​
另见