跳转到主要内容

​
你要付什么

OrcaRouter 按上游服务商公布的逐 token 价格收费，不在 token 上 加价。我们的营收来自可选的付费订阅计划，而不是抬高你的 token 成本。

​
usage 对象

每次 chat / responses 响应都包含 usage 字段： 
{
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 34,
    "total_tokens": 46
  }
}
推理模型还会附加 completion_tokens_details.reasoning_tokens， 对应隐藏的思考过程。

​
内置工具费用

当响应使用了内置/服务端工具时，每次调用都会按次计算并叠加在 token 用量之上。OrcaRouter 透传上游服务商的每次调用费率，不加价；具体 费率请查阅各服务商官方定价页。 各服务商按调用计费的工具：
  • OpenAI —— web_search、web_search_preview、image_generation （Responses API 内置工具）
  • Anthropic —— web_search（服务端工具）
  • Google Gemini —— googleSearch 接地（Gemini 2.x 系列按”被接地的 prompt”计；Gemini 3.x 系列按”查询次数”计）
  • xAI Grok —— web_search、x_search、code_interpreter （/v1/responses 上的 Agent Tools API）
当前透传的 OpenAI 具体费率：
工具单次调用费率
web_search$10 / 1,000 次调用（跨模型统一）
web_search_preview推理模型（o3*、o4*、gpt-5*）10/1k；非推理模型（‘gpt−4o∗‘、‘gpt−4.1∗‘等）10 / 1k；非推理模型（`gpt-4o*`、`gpt-4.1*` 等）25 / 1k
其他服务商的服务端工具费率，请查阅各服务商官方定价页。

​
OrcaRouter 响应头

响应头何时设置
X-Orca-Fallback-Level实际承接响应的回退模型索引
X-Orca-Fallback-Model回退模型名
X-Orca-Router所使用的 orcarouter/{name} 路由器名
X-Orca-Resolved-Model命名路由器解析到的具体模型
使用方式见路由 / 响应头。

​
查看用量

orcarouter.ai/console 控制台显示 每日花费、所选时间窗口内的总花费、以及按模型的分解。控制台当前不 按 API 密钥分项——花费在工作区维度聚合。 另外提供两个 OpenAI 形态的计费端点用于编程访问： 
# 截止目前的总用量（返回 OpenAIUsageResponse，包含 TotalUsage）
curl https://api.orcarouter.ai/v1/dashboard/billing/usage \
  -H "Authorization: Bearer sk-orca-..."

# 剩余额度与到期信息（返回 OpenAISubscriptionResponse）
curl https://api.orcarouter.ai/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer sk-orca-..."
这是汇总端点——不包含 OpenAI 那样的逐日历史明细。