Zum Hauptinhalt springen
OrcaRouter fügt jeder API-Antwort eine kleine Anzahl von Headern hinzu, damit du inspizieren kannst, wie deine Anfrage geroutet wurde. Sie sagen dir, welches Modell den Aufruf bedient hat (im gleichen Anbieter-präfixierten Format, das du als model übergibst); sie legen keine internen Routing-Details wie Kanal-Identifier oder Upstream-Backend-URLs offen.
HeaderVorhanden wennBeispielBedeutung
X-Orca-Fallback-Levelextra_body.models hat ein Fallback verursacht1Null-indizierte Position in deiner Fallback-Kette, die die Antwort bedient hat. 0 bedeutet, das primäre Modell war erfolgreich und das Fallback wurde nicht ausgelöst.
X-Orca-Fallback-ModelFallback ausgelöst (Stufe > 0)google/gemini-2.5-proDas Modell, das die Antwort tatsächlich bedient hat, nachdem das primäre fehlgeschlagen ist.
X-Orca-RouterDu hast orcarouter/{name} aufgerufenautoDer Name des Routers, den du aufgerufen hast.
X-Orca-Resolved-ModelDu hast orcarouter/{name} aufgerufenopenai/gpt-4o-miniDas konkrete Modell, auf das der Router zur Anforderungszeit aufgelöst hat.
Retry-AfterAntwort ist 429 Too Many Requests5Wie viele Sekunden zu warten, bevor erneut versucht wird.

​
Im Code lesen

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

​
Was OrcaRouter nicht offenlegt

Wir fügen absichtlich nicht hinzu:
  • Einen provider- oder routed_to-Header oder Antwortfeld
  • Jeden internen Routing-Identifier oder Upstream-Backend-URL
  • Jeden Header, der einem Aufrufer mitteilt, welcher Upstream die Anfrage bedient hat
OrcaRouter ist aus Sicht deiner Anwendung ein einzelner Anbieter. Internes Routing ist unsere Angelegenheit, nicht deine Abhängigkeit.