ToAPIsToAPIs
Формат Responses

Responses API

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

POST
/v1/responses

Для пользователей из материкового Китая: используйте 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

Модели с пометкой Responses Only, например gpt-5-pro-official и gpt-5.3-codex-official, поддерживают только этот API и не поддерживают Chat Completions. Подробности см. в списке моделей.

Авторизация

Authorizationstringзаголовокобязательно

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

Authorization: Bearer YOUR_API_KEY

Получите API key на странице управления API ключами.

Тело запроса

modelstringтелообязательно

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

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

inputstring | object[]телообязательно

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

instructionsstringтело

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

streambooleanтелопо умолчанию: false

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

max_output_tokensintegerтело

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

temperaturenumberтелопо умолчанию: 1

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

top_pnumberтелопо умолчанию: 1

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

previous_response_idstringтело

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

reasoningobjectтело

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

toolsobject[]тело

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

tool_choicestringтелопо умолчанию: auto

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

Ответ

idstring

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

objectstring

Всегда response.

statusstring

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

outputobject[]

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

usageobject

Статистика токенов: входные, выходные, 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"
  }'