Saltar para o conteúdo principal

​
O que você paga

O OrcaRouter cobra de você o preço por token publicado pelo provedor upstream, sem margem por token. A receita vem de planos de assinatura pagos opcionais, não de inflar seu custo por token.

​
O objeto usage

Toda resposta de chat/responses inclui um campo usage: 
{
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 34,
    "total_tokens": 46
  }
}
Modelos de raciocínio adicionam completion_tokens_details.reasoning_tokens para a passagem oculta de raciocínio.

​
Cobranças por ferramentas integradas

Quando a resposta usa uma ferramenta integrada / do lado do servidor, a chamada é contada e faturada acima do uso de tokens. O OrcaRouter repassa a taxa por chamada do provedor upstream sem margem; consulte a página de preços de cada provedor para taxas atuais. Ferramentas que disparam cobranças por chamada entre provedores:
  • OpenAI — web_search, web_search_preview, image_generation (ferramentas integradas da Responses API)
  • Anthropic — web_search (ferramenta de servidor)
  • Google Gemini — grounding googleSearch (por prompt grounded na família Gemini 2.x; por consulta na família Gemini 3.x)
  • xAI Grok — web_search, x_search, code_interpreter (API Agent Tools em /v1/responses)
Taxas específicas da OpenAI atualmente repassadas:
FerramentaTaxa por chamada
web_search$10 por 1.000 chamadas (unificado entre modelos)
web_search_preview10/1kparamodelosderaciocıˊnio(‘o3∗‘,‘o4∗‘,‘gpt−5∗‘);10 / 1k para modelos de raciocínio (`o3*`, `o4*`, `gpt-5*`); 25 / 1k para modelos não-raciocínio (gpt-4o*, gpt-4.1*, etc.)
Para taxas de ferramentas de servidor de outros provedores, veja a página de preços oficial de cada provedor.

​
Cabeçalhos de resposta do OrcaRouter

CabeçalhoQuando definido
X-Orca-Fallback-LevelÍndice do modelo de fallback que serviu a resposta
X-Orca-Fallback-ModelNome do modelo de fallback
X-Orca-RouterNome do roteador orcarouter/{name} usado
X-Orca-Resolved-ModelModelo concreto para o qual um roteador nomeado resolveu
Veja Roteamento / Cabeçalhos de resposta para casos de uso.

​
Consultando seu uso

O Painel em orcarouter.ai/console mostra gasto diário, gasto total em uma janela escolhida e detalhamento por modelo. O Painel atualmente não detalha o gasto por chave de API — os custos são agregados no nível do workspace. Dois endpoints de faturamento no formato OpenAI também são expostos para acesso programático: 
# Uso total até agora (retorna um OpenAIUsageResponse com TotalUsage)
curl https://api.orcarouter.ai/v1/dashboard/billing/usage \
  -H "Authorization: Bearer sk-orca-..."

# Cota restante e expiração (retorna OpenAISubscriptionResponse)
curl https://api.orcarouter.ai/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer sk-orca-..."
Esses são endpoints de resumo — eles não incluem o detalhamento histórico dia a dia completo da OpenAI.