응답 헤더 - OrcaRouter

OrcaRouter는 요청이 어떻게 라우팅되었는지 확인할 수 있도록 모든 API 응답에 소수의 헤더를 추가합니다. 어떤 모델이 호출을 처리했는지 (당신이 model로 전달하는 것과 동일한 프로바이더 접두사 형식으로) 알려줍니다; 채널 식별자나 업스트림 백엔드 URL 같은 내부 라우팅 세부 사항은 노출하지 않습니다.

헤더	설정 시점	예	의미
`X-Orca-Fallback-Level`	`extra_body.models`가 폴백을 일으킴	`1`	응답을 처리한 폴백 체인의 0-인덱스 위치. `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 Requests`	`5`	재시도 전 대기할 초.

코드에서 읽기

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는 단일 프로바이더입니다. 내부 라우팅은 우리의 관심사이며 당신이 의존할 것이 아닙니다.

​코드에서 읽기

​OrcaRouter가 노출하지 않는 것

코드에서 읽기

OrcaRouter가 노출하지 않는 것