Responses API
Формат OpenAI Responses API с function calling, встроенными инструментами и серверным контекстом
Для пользователей из материкового Китая: используйте 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"
}'