XuanShu API

Chat Completions API

OpenAI-совместимые запросы Chat Completions и потоковые ответы.

Последняя проверка: 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>.

Chat Completions API

POST /v1/chat/completions принимает совместимый формат сообщений; stream=true использует SSE.

Не все модели поддерживают одинаковые параметры; сначала запросите Models.

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

Chat Completions использует messages, поддерживает temperature и включает SSE через stream.

curl 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":"Reply with OK"}],"temperature":0,"stream":false}'

Ответ и streaming

Обычный текст находится в choices[0].message.content, streaming-части — в choices[0].delta.content.

HTTP 200
{"object":"chat.completion","choices":[{"message":{"role":"assistant","content":"OK"},"finish_reason":"stop"}],"usage":{"prompt_tokens":12,"completion_tokens":1}}

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

Параметр	Описание
model	Выберите из /v1/models.
messages	Роли и content диалога.
temperature	Используйте только при поддержке моделью.
stream	Включает SSE.

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

При 400 проверьте параметры модели; при 401/403 учетные данные и доступ; для 429/5xx применяйте ограниченный backoff.

HTTP 400  # model does not support a parameter
HTTP 401/403  # key or model access
HTTP 429/5xx  # bounded retry candidate

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

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