Ошибки

Неудачные запросы возвращают JSON с объектом error. Статус HTTP — это первый сигнал; поля message и code указывают фактическую неисправность.

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Общие коды состояния

Статус	Типичная причина
`400`	Неверный JSON, неподдерживаемое поле или неверная конечная точка модели.
`401`	Ключ API отсутствует или недействителен
`403`	Ключ не может использовать эту модель или группу
`404`	Неизвестный путь или отсутствующая задача
`429`	Ограничение скорости
`499`	Клиент отменил запрос
`5xx`	Сбой поставщика услуг или шлюза

Запросы изображений и видео, отправленные по неправильному протоколу, возвращают 400 с unsupported_endpoint и называют требуемый API. Тихое преобразование протокола предназначено только для текстовых моделей.

Более длительная диагностика, повторные попытки и откат описаны в технических статьях на основном сайте, начиная с Устранение ошибок AI API.