ДокументацияСправочник APIResponses API

Responses API

Совместимый с OpenAI эндпоинт Responses — поля запроса, формат ответа, стриминг.

POST/v1/responses

Чат-эндпоинт, совместимый с телом запроса OpenAI Responses API, — тот же интерфейс, который используют инструменты вроде Codex. Аутентификация через Authorization: Bearer.

Тело запроса

ПолеТипОбязательноеОписание
modelstringДаИдентификатор модели — см. Модели.
inputstring | arrayДаВвод пользователя: текст или массив сообщений для многоходовых/мультимодальных запросов.
instructionsstringНетСистемный промпт.
max_output_tokensintegerНетЛимит выходных токенов (не менее 16).
streambooleanНетПри true ответ передаётся потоком SSE — см. Стриминг.
temperature / tools / …—НетОстальные официальные поля пересылаются как есть; поддержка зависит от целевой модели.
request.sh
curl https://api.soleapi.com/v1/responses \
  -H "Authorization: Bearer $SOLEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "input": "Write a haiku about the sea",
    "max_output_tokens": 200
  }'

Ответ

response.json
{
  "id": "resp_abc123",
  "object": "response",
  "model": "claude-fable-5",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        { "type": "output_text", "text": "Waves fold into foam..." }
      ]
    }
  ],
  "usage": {
    "input_tokens": 14,
    "output_tokens": 23,
    "total_tokens": 37
  }
}

Числа токенов в usage — основа тарификации; официальные SDK возвращают текст через resp.output_text.

Связанные эндпоинты

  • POST /v1/responses/compact и POST /v1/responses/input_tokens: вспомогательные эндпоинты клиента Codex для сжатия контекста и оценки входных токенов.

POST /v1/chat/completions сохранён только для обратной совместимости. Все новые интеграции должны использовать Responses API.