Embeddings API

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

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

Embeddings API

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

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

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

Embeddings принимает model и input в виде строки или массива строк.

curl https://www.xuanshuapi.com/v1/embeddings \
  -H "Authorization: Bearer <YOUR_API_KEY>" -H "content-type: application/json" \
  -d '{"model":"<MODEL_FROM_MODELS>","input":["first document","second document"]}'

Ответ и streaming

Массив data возвращает vectors и index в порядке input; streaming не поддерживается.

HTTP 200
{"object":"list","data":[{"object":"embedding","index":0,"embedding":[0.012,-0.034]},{"object":"embedding","index":1,"embedding":[0.056,0.078]}],"usage":{"prompt_tokens":4,"total_tokens":4}}

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

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

При 400 проверьте тип input; при 404 model ID; модель без vector support завершится ошибкой.

HTTP 400  # invalid input type
HTTP 404  # model not found or unavailable
HTTP 429/5xx  # bounded retry candidate

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

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