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

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

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

<Info>
  **Только без состояния**

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

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

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

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

```json lines theme={null}
{
  "error": {
    "code": "invalid_prompt",
    "message": "Detailed error description"
  },
  "metadata": null
}
```

### Коды ошибок

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

| Код                               | Описание                                                                                 | Эквивалентный HTTP-статус |
| --------------------------------- | ------------------------------------------------------------------------------------------ | -------------------------- |
| `invalid_prompt`                  | Request or prompt validation failed (context length exceeded, invalid request fields)      | 400                        |
| `rate_limit_exceeded`             | Too many requests                                                                          | 429                        |
| `image_content_policy_violation`  | Input or output flagged by a content filter                                                | 400                        |
| `server_error`                    | Internal server error, authentication failure, provider overloaded/unavailable, or timeout | 500+                       |

Эти коды представляют упрощённое отображение [internal typed error codes](/docs/api_reference/errors-and-debugging#typed-error-codes). Несколько внутренних типов ошибок сводятся к каждому коду Responses API — например, `context_length_exceeded` и `invalid_request` здесь оба отображаются как `invalid_prompt`.

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

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

```json lines theme={null}
{
  "id": "resp_abc123",
  "status": "failed",
  "error": { "code": "server_error", "message": "Invalid credentials" },
  "error_type": "authentication"
}
```

Значение `error_type` соответствует одному из [typed error codes](/docs/api_reference/errors-and-debugging#typed-error-codes) и стабильно во всех форматах API VEGA. Используйте его для программного различения категорий ошибок, когда native `code` неоднозначен.