Skip to main content
POST
Responses API — новый agentic API от OpenAI. По сравнению с Chat Completions он добавляет более мощную работу с инструментами и серверное хранение контекста диалога.
  • Function calling: модель может вызывать пользовательские функции
  • Встроенные инструменты: например web_search_preview
  • Серверный контекст: используйте previous_response_id, не отправляя всю историю сообщений
  • Управление рассуждением: настройка глубины мышления через reasoning.effort
Модели с пометкой Responses Only, например gpt-5-pro-official и gpt-5.3-codex-official, поддерживают только этот API и не поддерживают Chat Completions. Подробности см. в списке моделей.

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

​
string
обязательно
Используйте Bearer Token.
Получите API key на странице управления API ключами.

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

​
string
обязательно
Название модели.Примеры: "gpt-5-pro-official", "gpt-5.3-codex-official", "gpt-5.2-official"
​
string | object[]
обязательно
Пользовательский ввод. Поддерживается строка или массив сообщений для многоходового диалога.
​
string
Системные инструкции для поведения модели.
​
boolean
по умолчанию:false
Включить потоковый вывод.
​
integer
Максимальное количество выходных токенов.
​
number
по умолчанию:1
Температура сэмплирования, диапазон 0–2.
​
number
по умолчанию:1
Порог nucleus sampling, диапазон 0–1.
​
string
ID предыдущего ответа для серверного многоходового контекста.
​
object
Конфигурация рассуждения. reasoning.effort: high, medium, low или none.
​
object[]
Доступные инструменты. Поддерживаются function и web_search_preview.
​
string
по умолчанию:"auto"
Стратегия выбора инструментов: auto, none или required.

​
Ответ

​
string
Уникальный ID ответа, который можно использовать как previous_response_id.
​
string
Всегда response.
​
string
Статус ответа: completed, failed или in_progress.
​
object[]
Элементы вывода, например message, function_call, reasoning или web_search_call.
​
object
Статистика токенов: входные, выходные, reasoning и total tokens.