Przejdź do głównej treści

Za co płacisz

OrcaRouter pobiera od Ciebie opublikowaną cenę per token upstreamowego dostawcy, bez narzutu per token. Przychody pochodzą z opcjonalnych płatnych planów subskrypcji, a nie z zawyżania kosztu tokenów.

Obiekt usage

Każda odpowiedź chat/responses zawiera pole usage:
{
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 34,
    "total_tokens": 46
  }
}
Modele reasoning dodają completion_tokens_details.reasoning_tokens dla ukrytego przejazdu reasoning.

Opłaty za narzędzia wbudowane

Gdy odpowiedź używa wbudowanego / server-side narzędzia, wywołanie jest liczone i rozliczane oprócz zużycia tokenów. OrcaRouter przekazuje stawkę per wywołanie upstreamowego dostawcy bez narzutu; aktualne stawki znajdziesz na stronie cennika każdego dostawcy. Narzędzia, które wywołują opłaty per wywołanie u różnych dostawców:
  • OpenAIweb_search, web_search_preview, image_generation (wbudowane narzędzia Responses API)
  • Anthropicweb_search (server tool)
  • Google GeminigoogleSearch grounding (per uziemniony prompt w rodzinie Gemini 2.x; per zapytanie w rodzinie Gemini 3.x)
  • xAI Grokweb_search, x_search, code_interpreter (Agent Tools API na /v1/responses)
Konkretne stawki OpenAI obecnie przekazywane:
NarzędzieStawka per wywołanie
web_search$10 za 1 000 wywołań (ujednolicone między modelami)
web_search_preview10/1kdlamodelireasoning(o3,o4,gpt5);10 / 1k dla modeli reasoning (`o3*`, `o4*`, `gpt-5*`); 25 / 1k dla modeli bez reasoning (gpt-4o*, gpt-4.1* itp.)
Stawki server-tool innych dostawców znajdziesz na ich oficjalnych stronach cennika.

Nagłówki odpowiedzi OrcaRouter

NagłówekKiedy ustawiony
X-Orca-Fallback-LevelIndeks modelu fallback, który obsłużył odpowiedź
X-Orca-Fallback-ModelNazwa modelu fallback
X-Orca-RouterNazwa użytego routera orcarouter/{name}
X-Orca-Resolved-ModelKonkretny model, do którego nazwany router się rozwinął
Zobacz Routing / Nagłówki odpowiedzi dla przypadków użycia.

Sprawdzanie zużycia

Panel pod orcarouter.ai/console pokazuje dzienne wydatki, łączne wydatki w wybranym oknie oraz podział per-model. Panel obecnie nie rozbija wydatków per klucz API — koszty są agregowane na poziomie workspace. Dwa endpointy rozliczeniowe w kształcie OpenAI są również udostępnione do dostępu programowego:
# Łączne zużycie do tej pory (zwraca OpenAIUsageResponse z TotalUsage)
curl https://api.orcarouter.ai/v1/dashboard/billing/usage \
  -H "Authorization: Bearer sk-orca-..."

# Pozostała kwota i wygaśnięcie (zwraca OpenAISubscriptionResponse)
curl https://api.orcarouter.ai/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer sk-orca-..."
To endpointy podsumowujące — nie zawierają pełnego historycznego rozbicia dzień po dniu od OpenAI.