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Следующие шаги
Доступные модели, множители, квоты и часть расширенных возможностей зависят от текущего ключа и конфигурации консоли.