XuanShu API

Responses API

HTTP, streaming и WebSocket для OpenAI Responses.

Последняя проверка: 2026-07-23

Подключение и аутентификация

Единый OpenAI-совместимый Base URL: https://www.xuanshuapi.com/v1

OpenAI-совместимые API используют Authorization: Bearer <YOUR_API_KEY>; Claude Messages также принимает x-api-key: <YOUR_API_KEY>; Gemini v1beta использует x-goog-api-key: <YOUR_API_KEY>.

Responses API

POST /v1/responses создаёт ответ; GET /v1/responses поддерживает WebSocket upgrade для совместимых клиентов.

Модели и расширенные возможности зависят от текущей конфигурации консоли.

Запрос и вызов

Responses использует input для строки или структуры и поддерживает stream.

curl https://www.xuanshuapi.com/v1/responses \
  -H "Authorization: Bearer <YOUR_API_KEY>" -H "content-type: application/json" \
  -d '{"model":"<MODEL_FROM_MODELS>","input":"Reply with OK","stream":false}'

Ответ и streaming

Завершенный ответ содержит status и output; при stream=true обрабатывайте события, а WebSocket upgrade требует отдельной логики.

HTTP 200
{"object":"response","status":"completed","output":[{"type":"message","role":"assistant","content":[{"type":"output_text","text":"OK"}]}]}

Ключевые параметры

Параметр	Описание
model	Модель ключа с поддержкой Responses.
input	Текстовый или структурированный input.
stream	Включает поток событий.

Типичные ошибки

400 обычно означает несовместимый input или параметры; при 401/403 проверьте ключ и права; 426 означает неверный WebSocket upgrade.

HTTP 400  # invalid input or parameter
HTTP 401/403  # authentication or permission
HTTP 426  # WebSocket upgrade required or invalid
HTTP 429/5xx  # bounded retry candidate

Следующие шаги

Доступные модели, множители, квоты и часть расширенных возможностей зависят от текущего ключа и конфигурации консоли.