跳轉到主要內容

你要付什么

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_searchweb_search_previewimage_generation (Responses API 內置工具)
  • Anthropic —— web_search(服務端工具)
  • Google Gemini —— googleSearch 接地(Gemini 2.x 系列按”被接地的 prompt”計;Gemini 3.x 系列按”查詢次數”計)
  • xAI Grok —— web_searchx_searchcode_interpreter/v1/responses 上的 Agent Tools API)
當前透傳的 OpenAI 具體費率:
工具單次調用費率
web_search$10 / 1,000 次調用(跨模型統一)
web_search_preview推理模型(o3*o4*gpt-5*10/1k;非推理模型(gpt4ogpt4.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 那樣的逐日歷史明細。