Перейти к основному содержанию
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 — единый провайдер. Внутренняя маршрутизация — наша забота, а не ваша зависимость.