API VEGA

Индекс документации

Получите полный индекс документации по адресу: https://api.vega.chat/docs/llms.txt Используйте этот файл, чтобы узнать о всех доступных страницах перед дальнейшим изучением.

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

MD версия

Понимание и обработка ошибок в Responses API

Только без состояния

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

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

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

Все ошибки следуют этой структуре:

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

Коды ошибок

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

КодОписаниеЭквивалентный HTTP-статус
invalid_promptRequest or prompt validation failed (context length exceeded, invalid request fields)400
rate_limit_exceededToo many requests429
image_content_policy_violationInput or output flagged by a content filter400
server_errorInternal server error, authentication failure, provider overloaded/unavailable, or timeout500+

Эти коды представляют упрощённое отображение internal typed error codes. Несколько внутренних типов ошибок сводятся к каждому коду Responses API — например, context_length_exceeded и invalid_request здесь оба отображаются как invalid_prompt.

Каноническое поле error_type

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

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

Значение error_type соответствует одному из typed error codes и стабильно во всех форматах API VEGA. Используйте его для программного различения категорий ошибок, когда native code неоднозначен.