> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Responses API

> Формат OpenAI Responses API с function calling, встроенными инструментами и серверным контекстом

> [!NOTE]
>
> **Для пользователей из материкового Китая:** используйте `https://toapis.cn` в качестве эндпоинта (Base URL). Замените `https://toapis.com` на `https://toapis.cn` во всех примерах этого документа.

Responses API — новый agentic API от OpenAI. По сравнению с Chat Completions он добавляет более мощную работу с инструментами и серверное хранение контекста диалога.

* **Function calling**: модель может вызывать пользовательские функции
* **Встроенные инструменты**: например `web_search_preview`
* **Серверный контекст**: используйте `previous_response_id`, не отправляя всю историю сообщений
* **Управление рассуждением**: настройка глубины мышления через `reasoning.effort`

> [!WARNING]
>
> Модели с пометкой **Responses Only**, например `gpt-5-pro-official` и `gpt-5.3-codex-official`, поддерживают только этот API и не поддерживают Chat Completions. Подробности см. в [списке моделей](https://docs.toapis.com/docs/ru/api-reference/chat/models.md).

## Авторизация

**Authorization** `string` *required*

Используйте Bearer Token.

```
Authorization: Bearer YOUR_API_KEY
```

Получите API key на [странице управления API ключами](https://toapis.com/console/token).

## Тело запроса

**model** `string` *required*

Название модели.

Примеры: `"gpt-5-pro-official"`, `"gpt-5.3-codex-official"`, `"gpt-5.2-official"`

**input** `string | object[]` *required*

Пользовательский ввод. Поддерживается строка или массив сообщений для многоходового диалога.

**instructions** `string`

Системные инструкции для поведения модели.

**stream** `boolean` (default: false)

Включить потоковый вывод.

**max\_output\_tokens** `integer`

Максимальное количество выходных токенов.

**temperature** `number` (default: 1)

Температура сэмплирования, диапазон `0`–`2`.

**top\_p** `number` (default: 1)

Порог nucleus sampling, диапазон `0`–`1`.

**previous\_response\_id** `string`

ID предыдущего ответа для серверного многоходового контекста.

**reasoning** `object`

Конфигурация рассуждения. `reasoning.effort`: `high`, `medium`, `low` или `none`.

**tools** `object[]`

Доступные инструменты. Поддерживаются `function` и `web_search_preview`.

**tool\_choice** `string` (default: auto)

Стратегия выбора инструментов: `auto`, `none` или `required`.

## Ответ

**id** `string`

Уникальный ID ответа, который можно использовать как `previous_response_id`.

**object** `string`

Всегда `response`.

**status** `string`

Статус ответа: `completed`, `failed` или `in_progress`.

**output** `object[]`

Элементы вывода, например `message`, `function_call`, `reasoning` или `web_search_call`.

**usage** `object`

Статистика токенов: входные, выходные, reasoning и total tokens.

```bash cURL theme={null}
curl --request POST \
  --url https://toapis.com/v1/responses \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5.3-codex-official",
    "instructions": "Ты профессиональный помощник по коду",
    "input": "Напиши quicksort на Python"
  }'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.