XuanShu API

Messages API

Публичные совместимые endpoints Claude Messages и подсчёта токенов.

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

Messages API

POST /v1/messages поддерживает обычные и потоковые ответы; POST /v1/messages/count_tokens оценивает токены до выполнения.

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

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

Передавайте system/user content в теле Messages; max_tokens обязателен, stream опционален.

curl https://www.xuanshuapi.com/v1/messages \
  -H "x-api-key: <YOUR_API_KEY>" -H "content-type: application/json" \
  -d '{"model":"<MODEL_FROM_MODELS>","max_tokens":256,"messages":[{"role":"user","content":"Reply with OK"}],"stream":false}'

Ответ и streaming

Обычный ответ возвращает content blocks и usage; stream=true передает события SSE.

HTTP 200
{"type":"message","role":"assistant","content":[{"type":"text","text":"OK"}],"usage":{"input_tokens":12,"output_tokens":1}}

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

Параметр	Описание
model	Claude model ID из Models или консоли.
messages	Роли и content по порядку.
max_tokens	Лимит выходных tokens.
stream	Включает события SSE.

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

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

HTTP 400  # invalid body or unsupported parameter
HTTP 401  # missing or invalid API key
HTTP 429  # quota or rate limit
HTTP 5xx  # recoverable service failure

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

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