Документация xVOLT
xVOLT — один шлюз ко всем моделям. Один ключ, один адрес, привычные форматы запросов. Менять программы не нужно: достаточно подставить наш адрес вместо адреса OpenAI или Anthropic.
С чего начать
- Зарегистрируйтесь и войдите в консоль.
- Создайте ключ: раздел Ключи → Добавить. Ключ начинается на
sk-. - В своей программе замените адрес и ключ на наши — всё.
Адрес и ключ
| Что | Значение |
|---|---|
| Адрес шлюза | https://xvolt.space |
| Формат OpenAI | https://xvolt.space/v1 |
| Формат Anthropic | https://xvolt.space |
| Ключ | sk-… из консоли |
Если программа просит «Base URL» — впишите https://xvolt.space/v1. Если просит только домен — https://xvolt.space.
Два формата в одном шлюзе
Шлюз понимает оба главных формата запросов, и обращаться можно к любой модели в любом из них.
OpenAI
POST https://xvolt.space/v1/chat/completions
Authorization: Bearer sk-…
Работает и /v1/models, и /v1/embeddings, и потоковая передача ("stream": true).
Anthropic
POST https://xvolt.space/v1/messages
x-api-key: sk-…
anthropic-version: 2023-06-01
Это нужно программам, которые умеют говорить только языком Claude, — например Claude Code.
Примеры кода
curl
curl https://xvolt.space/v1/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer sk-…" -d '{
"model": "claude-sonnet-4-6",
"messages": [{"role": "user", "content": "Привет!"}]
}'
Python
from openai import OpenAI
client = OpenAI(
api_key="sk-…",
base_url="https://xvolt.space/v1",
)
r = client.chat.completions.create(
model="claude-opus-4-6-thinking",
messages=[{"role": "user", "content": "Привет!"}],
)
print(r.choices[0].message.content)
Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-…",
baseURL: "https://xvolt.space/v1",
});
const r = await client.chat.completions.create({
model: "gemini-3.1-pro",
messages: [{ role: "user", content: "Привет!" }],
});
console.log(r.choices[0].message.content);
Настройка программ
Cursor
Настройки → Models → включить Override OpenAI Base URL, вписать https://xvolt.space/v1, ключ — свой. Затем добавить нужные названия моделей вручную.
Claude Code
Задать две переменные окружения и запускать как обычно:
export ANTHROPIC_BASE_URL=https://xvolt.space
export ANTHROPIC_AUTH_TOKEN=sk-…
claude
Cline и Roo Code (VS Code)
Провайдер — OpenAI Compatible. Base URL — https://xvolt.space/v1, ключ — свой, модель выбрать из списка.
Continue
models:
- name: xVOLT
provider: openai
model: claude-sonnet-4-6
apiBase: https://xvolt.space/v1
apiKey: sk-…
Open WebUI
Настройки → Соединения → OpenAI API: адрес https://xvolt.space/v1, ключ — свой. Модели подтянутся сами.
Модели
Полный список с ценами, задержкой и скоростью — на витрине моделей. Там же можно скопировать точное название модели одной кнопкой.
| Название | Чем хороша |
|---|---|
claude-opus-4-6-thinking | Самая сильная. Думает перед ответом: сложный код, разбор ошибок |
claude-sonnet-4-6 | Быстрая и сильная, отвечает за секунду. Рабочая лошадка |
gemini-3.1-pro | Умная модель Google, длинный контекст |
gemini-3.8-flash | Самая свежая быстрая от Google |
gemini-3.7-flash | Быстрая и дешёвая |
deepseek-v4-pro | Сильная и недорогая, миллион токенов контекста |
deepseek-v4-flash | Самая дешёвая. Для простых задач |
deepseek-v4-flash-vision-exp | Понимает картинки |
gpt-oss-120b | Открытая модель OpenAI, быстрая и очень дешёвая |
Список моделей отдаёт и сам шлюз: GET https://xvolt.space/v1/models.
Поиск в интернете
Все модели у нас видят интернет, и включают его сами — только когда без свежих данных не ответить. Ничего настраивать и никаких особых названий моделей не нужно.
- «Переверни строку на Python» — ответ за секунду, в сеть модель не ходит.
- «Какая последняя версия FastAPI?» — модель сама ищет, читает страницу и отвечает с датой.
За счёт этого ответы не устаревают вместе с моделью: она знает про сегодняшний день, а не только про то, чему её учили.
Ошибки и лимиты
| Код | Что значит | Что делать |
|---|---|---|
401 | Ключ не признан | Проверить ключ и что он не удалён в консоли |
403 | Нет доступа к этой модели | Проверить свою группу в консоли |
429 | Слишком часто | Подождать и повторить; в клиентах включить повторы |
503 | Такой модели нет | Сверить название с витриной |
Расход по каждому запросу виден в консоли, в разделе Журнал: модель, токены, стоимость, время.
Вопросы
Нужна ли подписка?
Нет. Платите только за то, что израсходовали, по ценам с витрины.
Один ключ на все модели?
Да. Один ключ работает и в формате OpenAI, и в формате Anthropic, для всех моделей сразу.
Мои запросы кто-то читает?
Шлюз хранит только служебные записи для подсчёта расхода: время, модель, число токенов. Текст переписки не сохраняется.
Что с потоковой передачей?
Работает у всех моделей: "stream": true в формате OpenAI, обычный поток событий в формате Anthropic.
Куда писать, если не работает?
В нашем сообществе — ссылки в подвале любой страницы.