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

# API ответов

> OpenAI-совместимый API ответов

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

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

API VEGA предоставляет OpenAI-совместимый доступ к нескольким моделям ИИ через единый интерфейс, разработанный как замена API ответов OpenAI. Этот безсостояний API предлагает расширенные возможности, включая рассуждения, вызов инструментов и интеграцию веб‑поиска, при этом каждый запрос независим и состояние на сервере не сохраняется.

## Базовый URL

```lines theme={null}
https://openrouter.ai/api/v1/responses
```

## Аутентификация

Все запросы требуют аутентификации с использованием вашего ключа VEGA:

<CodeGroup>
  ```typescript title="TypeScript" lines theme={null}
  const response = await fetch('https://openrouter.ai/api/v1/responses', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'openai/o4-mini',
      input: 'Hello, world!',
    }),
  });
  ```

  ```python title="Python" lines theme={null}
  import requests

  response = requests.post(
      'https://openrouter.ai/api/v1/responses',
      headers={
          'Authorization': 'Bearer YOUR_OPENROUTER_API_KEY',
          'Content-Type': 'application/json',
      },
      json={
          'model': 'openai/o4-mini',
          'input': 'Hello, world!',
      }
  )
  ```

  ```bash title="cURL" lines theme={null}
  curl -X POST https://openrouter.ai/api/v1/responses \
    -H "Authorization: Bearer YOUR_OPENROUTER_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "openai/o4-mini",
      "input": "Hello, world!"
    }'
  ```
</CodeGroup>

## Основные возможности

### [Базовое использование](./basic-usage)

Изучите основы выполнения запросов с простым текстовым вводом и обработки ответов.

### [Рассуждения](./reasoning)

Получите доступ к расширенным возможностям рассуждений с настраиваемыми уровнями усилий и зашифрованными цепочками рассуждений.

### [Вызов инструментов](./tool-calling)

Интегрируйте вызов функций с поддержкой параллельного выполнения и сложных взаимодействий инструментов.

### [Веб‑поиск](./web-search)

Включите возможности веб‑поиска с получением информации в реальном времени и аннотациями цитат.

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

API возвращает структурированные ответы об ошибках:

```json lines theme={null}
{
  "error": {
    "code": "invalid_prompt",
    "message": "Missing required parameter: 'model'."
  },
  "metadata": null
}
```

Для полного руководства по обработке ошибок см. [Обработка ошибок](./error-handling).

## Ограничения скорости

Стандартные ограничения скорости API VEGA применяются. См. [Ограничения API](/docs/api_reference/limits) для деталей.