← Cloudflare AI Gateway / ai-gateway / reference

Устранение неполадок

На этой странице рассматриваются распространённые проблемы при использовании AI Gateway. По вопросам, специфичным для конкретного провайдера, обращайтесь к документации соответствующего провайдера.

Если от вашего ИИ-провайдера приходят ошибки аутентификации, значит AI Gateway не передал корректные учётные данные дальше. Проверьте следующее:

1. Проверьте расположение заголовка: Убедитесь, что ваш токен Cloudflare указан в cf-aig-authorization, а не Authorization. Authorization заголовок зарезервирован для учетных данных провайдера.

2. Проверьте конфигурацию в зависимости от типа эндпойнта:

   • Специфичные для провайдера эндпойнты: убедитесь, что URL вашего запроса включает путь провайдера (например, /google-vertex-ai/ или /openai/). AI Gateway использует это для определения поставщика и применения нужных сохраненных учетных данных.
   • Unified /compat/chat/completions конечная точка: подтвердите свой model имя начинается с префикса провайдера (например, google-vertex-ai/google/gemini-2.5-flash или openai/gpt-4o). AI Gateway использует этот префикс для маршрутизации запроса и выбора нужных сохраненных учетных данных.

3. Проверьте выбор ключа BYOK: Если для провайдера настроено несколько ключей, убедитесь в одном из следующих условий:

   • Вы используете ключ с псевдонимом default, или
   • Вы указываете cf-aig-byok-alias заголовок с правильным именем псевдонима

4. Проверьте конфигурацию BYOK: Если вы используете BYOK, убедитесь в панели управления, что ваши учётные данные сохранены корректно.

При проблемах с аутентификацией для конкретного провайдера:

• Устранение неполадок Google Vertex AI

По вопросам устранения неполадок Data Loss Prevention, таких как DLP не срабатывает или неожиданная блокировка, см. Устранение неполадок DLP.

• Проверьте, не возникли ли проблемы у вышестоящего поставщика
• Рассмотрите возможность внедрения динамическая маршрутизация с резервными переходами для временных сбоев
• Проверьте свои ограничение частоты запросов конфигурация

• Проверьте, что ваш API-ключ или учётные данные действительны непосредственно у провайдера
• Проверьте страницу статуса поставщика на наличие сбоев
• Проверьте логи AI Gateway для получения подробной информации об ошибке

• Проверьте кэширование включено для вашего шлюза
• Проверьте, что метод запроса и тип содержимого пригодны для кэширования
• Потоковые ответы по умолчанию не кешируются

• Проверьте настройки TTL кэша
• Проверьте, нет ли у вас заголовков запроса, которые обход кэша или установив пользовательский ключ кеша.