Обработка ошибок

StatelessЭтот API stateless — каждый запрос независим, и между запросами не сохраняется состояние диалога. Вы должны включать полную историю разговоров в каждый запрос. Запросы, которые устанавливают store: true или ненулевое значение previous_response_id отклоняются с 400 ошибка.

Responses API возвращает структурированные ответы об ошибках, которые соответствуют единообразному формату.

Формат ответа об ошибке

Все ошибки имеют следующую структуру:

{
  "error": {
    "code": "invalid_prompt",
    "message": "Detailed error description"
  },
  "metadata": null
}

Коды ошибок

API использует следующие коды ошибок:

Код	Описание	Эквивалентный статус HTTP
`invalid_prompt`	Ошибка проверки запроса или подсказки (превышена длина контекста, недопустимые поля запроса)	400
`rate_limit_exceeded`	Слишком много запросов	429
`image_content_policy_violation`	Ввод или вывод, помеченные фильтром содержимого	400
`server_error`	Внутренняя ошибка сервера, сбой аутентификации, провайдер перегружен/недоступен или истекло время ожидания	500+

Эти коды представляют собой сокращенное отображение внутренних типизированных кодов ошибок. Несколько типов внутренних ошибок объединяются в каждый код Responses API, например: context_length_exceeded и Параметры invalid_request оба появляются как invalid_prompt здесь.

Канонический `error_type` Поле

Потому что родной error.code словарный запас теряется (многие отдельные ошибки сворачиваются в server_error), неудавшиеся ответы также включают сообщение верхнего уровня. Поле error_type , содержащее точный тип канонической ошибки: Значение

{
  "id": "resp_abc123",
  "status": "failed",
  "error": { "code": "server_error", "message": "Invalid credentials" },
  "error_type": "authentication"
}

Объект error_type соответствует одному из введенных кодов ошибок и стабилен во всех форматах API LLMSTORE. Используйте его для программного различения категорий ошибок, когда встроенный code неоднозначно.

Руководства API

Responses API

Версионирование

Эндпоинты

Формат ответа об ошибке

Коды ошибок

Канонический `error_type` Поле

​Формат ответа об ошибке

​Коды ошибок

​Канонический error_type Поле

Формат ответа об ошибке

Коды ошибок

Канонический `error_type` Поле