Vai al contenuto principale

​
Cosa paghi

OrcaRouter ti addebita il prezzo per token pubblicato dal provider upstream, senza alcun ricarico per token. I ricavi provengono dai piani di abbonamento a pagamento opzionali, non dal gonfiamento del costo dei token.

​
L’oggetto usage

Ogni risposta chat/responses include un campo usage: 
{
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 34,
    "total_tokens": 46
  }
}
I modelli di reasoning aggiungono completion_tokens_details.reasoning_tokens per il passaggio di reasoning nascosto.

​
Addebiti per strumenti built-in

Quando la risposta usa uno strumento built-in / server-side, la chiamata viene contata e fatturata in aggiunta all’uso di token. OrcaRouter trasferisce la tariffa per chiamata del provider upstream senza ricarico; fai riferimento alla pagina di pricing di ciascun provider per le tariffe attuali. Strumenti che generano addebiti per chiamata tra i vari provider:
  • OpenAI — web_search, web_search_preview, image_generation (strumenti built-in della Responses API)
  • Anthropic — web_search (server tool)
  • Google Gemini — grounding googleSearch (per prompt grounded sulla famiglia Gemini 2.x; per query sulla famiglia Gemini 3.x)
  • xAI Grok — web_search, x_search, code_interpreter (Agent Tools API su /v1/responses)
Tariffe OpenAI specifiche attualmente trasferite:
StrumentoTariffa per chiamata
web_search$10 per 1.000 chiamate (unificato tra modelli)
web_search_preview10/1kpermodellidireasoning(‘o3∗‘,‘o4∗‘,‘gpt−5∗‘);10 / 1k per modelli di reasoning (`o3*`, `o4*`, `gpt-5*`); 25 / 1k per modelli non-reasoning (gpt-4o*, gpt-4.1*, ecc.)
Per le tariffe dei server-tool di altri provider, consulta la pagina di pricing ufficiale di ciascun provider.

​
Header di risposta OrcaRouter

HeaderQuando viene impostato
X-Orca-Fallback-LevelIndice del modello di fallback che ha servito la risposta
X-Orca-Fallback-ModelNome del modello di fallback
X-Orca-RouterNome del router orcarouter/{name} utilizzato
X-Orca-Resolved-ModelModello concreto a cui si è risolto un router con nome
Vedi Routing / Header di risposta per i casi d’uso.

​
Consultare il tuo utilizzo

La Dashboard su orcarouter.ai/console mostra la spesa giornaliera, la spesa totale su una finestra scelta e un breakdown per modello. La Dashboard attualmente non scompone la spesa per chiave API — i costi sono aggregati a livello di workspace. Sono anche esposti due endpoint di fatturazione in stile OpenAI per l’accesso programmatico: 
# Total usage so far (returns an OpenAIUsageResponse with TotalUsage)
curl https://api.orcarouter.ai/v1/dashboard/billing/usage \
  -H "Authorization: Bearer sk-orca-..."

# Remaining quota and expiry (returns OpenAISubscriptionResponse)
curl https://api.orcarouter.ai/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer sk-orca-..."
Questi sono endpoint di riepilogo — non includono il breakdown storico giornaliero completo di OpenAI.