ДокументацияСправочник 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://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.

Другие OpenAI-совместимые эндпоинты

С тем же заголовком авторизации доступны и эндпоинты ниже; формы запросов и ответов совпадают с оригиналами OpenAI:

ЭндпоинтНазначениеТарификация
POST /v1/embeddingsВекторные представления текста (text-embedding-3-small / -large)За входные токены
POST /v1/images/generations · /v1/images/editsГенерация и редактирование изображений, см. Изображения и видеоЗа изображение
POST /v1/videos/generations · /v1/videos/edits · GET /v1/videos/{request_id}Асинхронная генерация видео (Grok Imagine), см. Изображения и видеоЗа секунду, списание после готовности ролика
POST /v1/responses/compact · /v1/responses/input_tokens · /v1/alpha/searchСжатие контекста, оценка входных токенов и веб-поиск, используемые клиентом CodexСжатие — за токены; оценка — бесплатно; поиск — за вызов
GET /v1/usageБаланс аккаунта и суммарные траты, см. Тарификация и балансБесплатно, учитывается в RPM
embeddings.sh
curl https://soleapi.com/v1/embeddings \
  -H "Authorization: Bearer $SOLEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "The quick brown fox"
  }'

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