XuanShu API

Streaming и WebSocket

SSE streaming, Responses WebSocket и обработка разрывов соединения.

Последняя проверка:

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

Единый 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>.

Streaming и WebSocket

Messages, Responses, Chat Completions и некоторые Gemini actions поддерживают streaming; клиент должен обрабатывать события, таймауты и прерывания.

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

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

Сначала проверьте SSE; Responses WebSocket требует правильного upgrade и управления соединением.

curl -N https://www.xuanshuapi.com/v1/chat/completions \
  -H "Authorization: Bearer <YOUR_API_KEY>" -H "content-type: application/json" \
  -d '{"model":"<MODEL_FROM_MODELS>","messages":[{"role":"user","content":"Count to three"}],"stream":true}'

Ответ и streaming

SSE передает deltas в строках data и завершает терминальным событием; клиент должен учитывать пустые deltas и разрывы.

HTTP 200
data: {"choices":[{"delta":{"content":"1"}}]}
data: {"choices":[{"delta":{"content":" 2"}}]}
data: [DONE]

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

ПараметрОписание
modelДолжна поддерживать выбранный streaming-протокол.
streamУстановите true.
timeoutТаймауты подключения и чтения.

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

Исправьте 401/403 до handshake; при 426 проверьте WebSocket upgrade; при повторе после разрыва избегайте дублирования и стоимости.

HTTP 401/403  # authentication before streaming
HTTP 426  # invalid WebSocket upgrade
HTTP 429/5xx  # bounded reconnect candidate

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

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