Responses

Генерация и продолжение диалога в формате Responses

Создаёт ответ по входному тексту

POST https://api.getapi.ru/v1/responses

Параметры

Поле	Тип	Обязательное	Описание
`model`	string	Да	Идентификатор модели
`input`	string	Да	Входной текст
`max_output_tokens`	integer	Нет	Запрашиваемый лимит вывода, поддержка зависит от модели
`stream`	boolean	Нет	Поток событий
`reasoning`	object	Нет	Настройки рассуждений
`store`	boolean	Нет	Запрос на хранение ответа
`previous_response_id`	string	Нет	Идентификатор предыдущего ответа для поддерживаемого продолжения

Передавайте Authorization: Bearer <key> и Content-Type: application/json

Пример запроса

bash

curl https://api.getapi.ru/v1/responses \
  -H "Authorization: Bearer $GETAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1-mini",
    "input": "Объясни назначение HTTP одним предложением",
    "max_output_tokens": 128,
    "store": false
  }'

Пример ответа

Сокращённый объект Responses

json

{
  "id": "resp_example",
  "object": "response",
  "status": "completed",
  "model": "gpt-4.1-mini",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [{"type": "output_text", "text": "HTTP определяет обмен запросами и ответами между клиентом и сервером"}]
    }
  ],
  "usage": {"input_tokens": 16, "output_tokens": 20, "total_tokens": 36}
}

Обходите все элементы output и блоки content Текстовые блоки имеют type: "output_text" Другие элементы могут содержать рассуждения или дополнительные данные

Совместимость моделей

На этом методе структура ответа и поддержка состояния зависят от модели и маршрута обработки Совместимое подключение может вернуть другой формат ответа для модели или маршрута, например Chat Completions вместо Responses Если приложению нужна единая схема, закрепите формат и проверяйте фактический ответ до обработки

Проверяйте фактическую структуру: наличие output, choices, usage и статуса Не определяйте совместимость по поставщику модели или префиксу идентификатора ответа

Продолжение диалога

При поддерживаемом хранении передайте id прошлого ответа в previous_response_id Предыдущий контекст учитывается как входные токены

Не все возвращаемые идентификаторы пригодны для продолжения При 400 Invalid Responses API request не повторяйте неизменный запрос Храните историю в приложении, чтобы восстановить диалог через Chat Completions Срок хранения серверного состояния не гарантируется этой страницей

Лимиты и хранение

max_output_tokens не является финансовым ограничением Модель или маршрут может обработать запрошенный лимит вывода иначе, чем ожидает клиент Оценивайте расход по usage и не используйте лимит как гарантию верхней стоимости

Передавайте store явно, если используете этот параметр Ответ store: true не гарантирует доступность метода чтения GET /v1/responses/{id} не используйте для надёжного хранения результата, сохраняйте его в приложении

Потоковые события

Текст поступает в delta события response.output_text.delta Событие response.output_text.done содержит уже собранный текст, не добавляйте его повторно Итоговый ответ и счётчики поступают в response.completed Также обрабатывайте ошибку и прерывание до завершающего события

Ошибки

Отсутствие model или input вызывает 400 Для остальных ошибок используйте общий обработчик Встроенные инструменты прямого Responses API не считаются доступными только по совпадению имени метода

← GenerateContent

Embeddings →