XuanShu API

Gemini v1beta API

Нативные Gemini-совместимые Models, сведения о модели и model actions.

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

Gemini v1beta API

Используйте /v1beta/models для поиска моделей и /v1beta/models/{model}:{action} для поддерживаемых действий.

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

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

Нативный Gemini помещает модель в путь, а contents — в JSON.

curl "https://www.xuanshuapi.com/v1beta/models/MODEL_FROM_MODELS:generateContent" \
  -H "x-goog-api-key: <YOUR_API_KEY>" -H "content-type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Reply with OK"}]}]}'

Ответ и streaming

generateContent возвращает candidates; streamGenerateContent передает инкрементальные результаты.

HTTP 200
{"candidates":[{"content":{"role":"model","parts":[{"text":"OK"}]},"finishReason":"STOP"}]}

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

Параметр	Описание
model	Замените MODEL_FROM_MODELS в пути.
contents	Роли и content в parts.
generationConfig	Задавайте только поддерживаемые параметры.

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

При 400 проверьте action и тело; при 404 путь модели; при 401/403 x-goog-api-key и доступ.

HTTP 400  # unsupported action or invalid body
HTTP 401/403  # x-goog-api-key or permission
HTTP 404  # model path not available
HTTP 429/5xx  # bounded retry candidate

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

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