Справочник API
Responses
Новый формат ответов
POST
/v1/responsesМаршрут для клиентов, которые уже используют Responses API.
Пример запроса
curl {{PUBLIC_API_BASE_URL}}/responses \
-H "Authorization: Bearer gw_live_..." \
-H "Content-Type: application/json" \
-d '{
"model": "provider/model-name",
"input": "Объясни разницу между рабочим пространством и ключом API."
}'Когда использовать
- если ваш клиент уже построен вокруг Responses API;
- если нужен единый формат для разных типов входных данных;
- если конкретная модель лучше документирована для этого формата.
Параметры тела запроса
| Поле | Обязательность | Описание |
|---|---|---|
model | Да | Публичное имя модели. |
input | Да | Входной текст или структурированный ввод. |
instructions | Нет | Общая инструкция для модели. |
temperature | Нет | Свобода генерации. |
max_output_tokens | Нет | Максимум выходных токенов. |
stream | Нет | Потоковый ответ, если поддерживается. |
tools | Нет | Инструменты, если модель их поддерживает. |
Поля ответа
| Поле | Обязательность | Описание |
|---|---|---|
id | Да | Идентификатор ответа. |
object | Да | Тип объекта. |
status | Нет | Статус обработки. |
model | Да | Модель ответа. |
output | Да | Массив выходных элементов. |
output_text | Нет | Удобное текстовое представление, если клиент его формирует. |
usage | Нет | Использование токенов. |
Пример ответа
{
"id": "resp_example",
"object": "response",
"status": "completed",
"model": "provider/model-name",
"output": [
{
"type": "message",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "Рабочее пространство разделяет проекты, а ключ API даёт приложению доступ к выбранному пространству."
}
]
}
],
"usage": {
"input_tokens": 18,
"output_tokens": 21,
"total_tokens": 39
}
}