Перейти к основному содержанию
POST
/
v1
/
responses
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"
  }'

{
  "id": "<string>",
  "object": "<string>",
  "status": "<string>",
  "output": [
    {}
  ],
  "usage": {}
}
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. Подробности см. в списке моделей.

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

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

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

​
model
string
обязательно
Название модели.Примеры: "gpt-5-pro-official", "gpt-5.3-codex-official", "gpt-5.2-official"
​
input
string | object[]
обязательно
Пользовательский ввод. Поддерживается строка или массив сообщений для многоходового диалога.
​
instructions
string
Системные инструкции для поведения модели.
​
stream
boolean
по умолчанию:false
Включить потоковый вывод.
​
max_output_tokens
integer
Максимальное количество выходных токенов.
​
temperature
number
по умолчанию:1
Температура сэмплирования, диапазон 0–2.
​
top_p
number
по умолчанию: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
по умолчанию:"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.
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"
  }'