Header di risposta - OrcaRouter

OrcaRouter aggiunge un piccolo numero di header ad ogni risposta API in modo che tu possa ispezionare come è stata instradata la tua richiesta. Ti dicono quale modello ha servito la chiamata (nello stesso formato con prefisso di provider che passeresti come model); non espongono dettagli interni di routing come identificatori di canale o URL di backend upstream.

Header	Presente quando	Esempio	Significato
`X-Orca-Fallback-Level`	`extra_body.models` ha causato un fallback	`1`	Posizione zero-indicizzata nella tua catena di fallback che ha servito la risposta. `0` significa che il modello principale ha avuto successo e il fallback non si è attivato.
`X-Orca-Fallback-Model`	Fallback attivato (livello > 0)	`google/gemini-2.5-pro`	Il modello che ha effettivamente servito la risposta dopo il fallimento del principale.
`X-Orca-Router`	Hai chiamato `orcarouter/{name}`	`auto`	Il nome del router che hai invocato.
`X-Orca-Resolved-Model`	Hai chiamato `orcarouter/{name}`	`openai/gpt-4o-mini`	Il modello concreto a cui il router si è risolto al momento della richiesta.
`Retry-After`	La risposta è `429 Too Many Requests`	`5`	Quanti secondi attendere prima di riprovare.

Leggerli nel codice

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

Cosa OrcaRouter non espone

Deliberatamente non aggiungiamo:

Un header o campo di risposta provider o routed_to
Alcun identificatore interno di routing o URL di backend upstream
Alcun header che dica a un chiamante quale upstream ha servito la richiesta

OrcaRouter è un provider unico dal punto di vista della tua applicazione. Il routing interno è una nostra preoccupazione, non una tua dipendenza.

​Leggerli nel codice

​Cosa OrcaRouter non espone

Leggerli nel codice

Cosa OrcaRouter non espone