← Cloudflare AI Gateway / ai-gateway

Глоссарий заголовков

AI Gateway поддерживает множество заголовков, которые помогают настраивать, персонализировать ваши запросы API и управлять ими. На этой странице приведён полный список всех поддерживаемых заголовков с кратким описанием

Термин	Определение
cf-aig-backoff	Заголовок для настройки типа задержки для повторные попытки запроса запроса.
cf-aig-cache-key	cf-aig-cache-key-aig-cache-key позволяют переопределить ключ кеша по умолчанию, чтобы точно задать параметр кешируемости для любого ресурса.
cf-aig-cache-status	Индикатор статуса кэширования, показывающий, был ли запрос обслужен из кэша.
cf-aig-cache-ttl	Определяет время жизни кеша для ответов.
cf-aig-collect-log	cf-aig-collect-log заголовок позволяет обойти настройку журналирования по умолчанию для шлюза.
cf-aig-custom-cost	Разрешает настройка стоимости запроса чтобы отразить параметры, заданные пользователем.
cf-aig-dlp	Заголовок ответа, который возвращается, когда Политика DLP соответствует запросу или ответу. Содержит JSON с выполненным действием (Flag или Block), ID совпавших политик, ID совпавших профилей и ID записей обнаружения.
cf-aig-event-id	cf-aig-event-id это уникальный идентификатор события, используемый для отслеживания конкретных событий в системе.
cf-aig-log-id	cf-aig-log-id это уникальный идентификатор конкретной записи журнала, к которой вы хотите добавить отзыв.
cf-aig-max-attempts	Заголовок для настройки максимального количества попыток для повторные попытки запроса запроса.
cf-aig-metadata	Пользовательские метаданныепозволяет помечать запросы идентификаторами пользователей или другими идентификаторами, что даёт более точное отслеживание и анализ ваших запросов.
cf-aig-request-timeout	Заголовок для установки таймаут запроса (измеряется в миллисекундах). Если провайдер не отвечает за это время, запрос возвращает ошибку.
cf-aig-retry-delay	Заголовок для настройки задержки повторных попыток для повторные попытки запроса запроса.
cf-aig-skip-cache	Заголовок для обходить кеширование для конкретного запроса.
cf-aig-step	Заголовок ответа cf-aig-step показывает, какой шаг в цепочке обработки запроса успешно его обработал. Это полезно для отслеживания и отладки.
cf-cache-ttl	Устарело: этот заголовок заменён на `cf-aig-cache-ttl`. Он задаёт время жизни кеша.
cf-skip-cache	Устарело: этот заголовок заменён на `cf-aig-skip-cache`. Это обходит кеширование для конкретного запроса.

Иерархия конфигурации

Настройки в AI Gateway можно задать на двух уровнях: Запрос и Gateway. Поскольку одни и те же настройки можно задать в нескольких местах, порядок приоритета определяет, какое значение будет применено:

Заголовки на уровне запроса: Заголовки, указанные в отдельных запросах, имеют приоритет над настройками уровня шлюза.
Настройки на уровне шлюза: Применяется по умолчанию, если на уровне запроса заголовки не заданы.

Такая иерархия обеспечивает предсказуемое поведение, отдавая приоритет наиболее специфичным конфигурациям. Используйте заголовки уровня запроса для точной настройки, а настройки шлюза для общих значений по умолчанию.