Przejdź do głównej treści
OrcaRouter dodaje niewielką liczbę nagłówków do każdej odpowiedzi API, abyś mógł sprawdzić, jak Twoje żądanie zostało routowane. Mówią one, który model obsłużył wywołanie (w tym samym formacie z prefiksem dostawcy, którego przekazałbyś jako model); nie wystawiają wewnętrznych szczegółów routingu, takich jak identyfikatory kanałów ani URL-i backendów upstream.
NagłówekObecny, gdyPrzykładZnaczenie
X-Orca-Fallback-Levelextra_body.models spowodował fallback1Pozycja od zera w łańcuchu fallback, która obsłużyła odpowiedź. 0 oznacza, że główny model się powiódł i fallback nie zadziałał.
X-Orca-Fallback-ModelFallback zadziałał (poziom > 0)google/gemini-2.5-proModel, który faktycznie obsłużył odpowiedź po awarii głównego.
X-Orca-RouterWywołałeś orcarouter/{name}autoNazwa wywołanego routera.
X-Orca-Resolved-ModelWywołałeś orcarouter/{name}openai/gpt-4o-miniKonkretny model, do którego router się rozwinął w czasie żądania.
Retry-AfterOdpowiedź to 429 Too Many Requests5Ile sekund odczekać przed ponowieniem.

​
Odczyt w kodzie

response = client.chat.completions.with_raw_response.create(
    model="orcarouter/auto",
    messages=[...],
)
print(response.headers.get("X-Orca-Resolved-Model"))

​
Czego OrcaRouter nie wystawia

Świadomie nie dodajemy:
  • Nagłówka ani pola odpowiedzi provider lub routed_to
  • Żadnego wewnętrznego identyfikatora routingu ani URL-u backendu upstream
  • Żadnego nagłówka mówiącego wywołującemu, który upstream obsłużył żądanie
OrcaRouter jest jednym dostawcą z punktu widzenia Twojej aplikacji. Wewnętrzny routing to nasza sprawa, nie Twoja zależność.