跳轉到主要內容
OrcaRouter 在每次 API 響應中加入少量響應頭，便于你查看請求被如何 路由。它們告訴你哪個模型承接了這次調用（用的就是你作為 model 傳 入的那種帶服務商前綴的格式）；它們不暴露內部路由細節，如通道 標識或上游后端 URL。
響應頭出現條件示例含義
X-Orca-Fallback-Levelextra_body.models 觸發了回退1你回退鏈中實際承接響應的零基序號。0 表示主模型成功，回退未觸發。
X-Orca-Fallback-Model回退觸發（level > 0）google/gemini-2.5-pro主模型失敗后實際承接響應的模型。
X-Orca-Router你調用了 orcarouter/{name}auto你調用的路由器名。
X-Orca-Resolved-Model你調用了 orcarouter/{name}openai/gpt-4o-mini路由器在請求時解析到的具體模型。
Retry-After響應是 429 Too Many Requests5重試前應等待的秒數。

​
在代碼中讀取

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

​
OrcaRouter 不會暴露什么

我們刻意不加入：
  • provider 或 routed_to 響應頭/字段
  • 任何內部路由標識或上游后端 URL
  • 任何告訴調用方哪個上游承接了請求的響應頭
從你應用的視角看，OrcaRouter 是單一服務商。內部路由是我們要操心的 事，不是你需要依賴的東西。