Ошибки и диагностика

DDTokens — это шлюз API моделей. Ошибки могут возникать в системе аккаунтов DDTokens, сетевом соединении или сервисе вышестоящего провайдера. Сначала определите источник и только потом решайте, повторять ли запрос.

Распространенные типы ошибок

Тип	Частая причина	Повторять запрос?
Ошибка аутентификации	API-ключ недействителен, отключен, просрочен или неверно оформлен заголовок	Нет, сначала исправьте ключ
Ошибка баланса	Недостаточно средств на аккаунте или квоты токена	Нет, сначала пополните баланс или измените квоту
Ограничение частоты	Частота запросов превышает лимит аккаунта или токена	Да, после задержки
Ошибка вышестоящего сервиса	Модель перегружена, недоступна или отклонила параметры	Зависит от ошибки
Тайм-аут	Запрос превысил тайм-аут клиента, сети или шлюза	Можно повторить после сокращения ответа или изменения стратегии

Ошибка аутентификации

Проверьте следующее:

1. Заголовок запроса имеет вид Authorization: Bearer <API_KEY>.
2. API-ключ скопирован полностью.
3. API-ключ принадлежит текущему аккаунту.
4. API-ключ не отключен, не удален и не просрочен.

Недостаточный баланс

Может быть исчерпан баланс аккаунта или квота отдельного токена. Откройте панель управления и проверьте:

• Доступный баланс аккаунта.
• Доступную квоту текущего токена.
• Была ли списана плата за последний неудачный запрос.

Ограничение частоты

При ошибке 429 или аналогичном ограничении уменьшите параллелизм и используйте экспоненциальную задержку:

1s -> 2s -> 4s -> 8s

Не повторяйте запросы непрерывно без пауз. Это замедляет восстановление и может включить более строгую защиту.

Ошибки вышестоящего сервиса

Обычно они связаны с провайдером модели, параметрами или временной нехваткой ресурсов. Попробуйте:

• Переключиться на более стабильную модель.
• Удалить параметры с неподтвержденной поддержкой.
• Уменьшить длину ответа.
• Проверить, не указана ли недоступная модель или префикс провайдера.

Перед обращением в поддержку

Для быстрой диагностики подготовьте:

• Время запроса.
• Имя API-ключа, но не полный ключ.
• Имя модели.
• Код состояния HTTP.
• Тело ответа с ошибкой.
• Идентификатор запроса из журнала панели управления, если он доступен.