> Для получения чистого Markdown любой страницы добавьте .md к URL страницы.  
> Для полного индекса документации см. https://api.vega.chat/docs/llms.txt.  
> Для полного содержания документации см. https://api.vega.chat/docs/llms-full.txt.  
> Для интеграции AI‑клиентов (Claude Code, Cursor и др.) подключитесь к MCP‑серверу по адресу https://api.vega.chat/docs/_mcp/server.

# Responses API Beta

Этот API находится в **бета‑версии** и может содержать несовместимые изменения. Используйте его с осторожностью в производственных средах.

Этот API **без состояния** — каждый запрос независим, и состояние диалога между запросами не сохраняется. Вы должны включать полную историю диалога в каждый запрос.

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

## Base URL

```
https://api.vega.chat/api/v1/responses
```

## Authentication

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

```typescript title="TypeScript"
const response = await fetch('https://api.vega.chat/api/v1/responses', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_VEGA_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/o4-mini',
    input: 'Hello, world!',
  }),
});
```

```python title="Python"
import requests

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

```bash title="cURL"
curl -X POST https://api.vega.chat/api/v1/responses \
  -H "Authorization: Bearer YOUR_VEGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/o4-mini",
    "input": "Hello, world!"
  }'
```

## Core Features

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

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

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

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

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

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

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

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

## Error Handling

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

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

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

## Rate Limits

Стандартные ограничения VEGA применяются. Подробнее см. [API Limits](/docs/api-reference/limits).