Документация API
OpenAI-совместимый API для доступа к 80+ языковым моделям. Оплата в рублях, без VPN.
Быстрый старт
Clavis.to — единый OpenAI-совместимый API для 80+ нейросетей. Для начала нужен только API-ключ.
Создайте аккаунт
Зарегистрируйтесь на clavis.to
Пополните баланс
Оплата в рублях, от 100₽
Создайте API-ключ
Dashboard → API-ключи
Отправьте запрос
Любой OpenAI SDK
Первый запрос
bashcurl https://api.clavis.to/v1/chat/completions \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "Hello!"}]
}'Python (OpenAI SDK)
pythonfrom openai import OpenAI
client = OpenAI(
api_key="sk-your-api-key",
base_url="https://api.clavis.to/v1"
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)JavaScript / TypeScript (OpenAI SDK)
javascriptimport OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-your-api-key",
baseURL: "https://api.clavis.to/v1",
});
const response = await client.chat.completions.create({
model: "gpt-4o",
messages: [{ role: "user", content: "Hello!" }],
});
console.log(response.choices[0].message.content);Аутентификация
Все запросы к API требуют заголовок Authorization с API-ключом. Ключи создаются в Dashboard → API-ключи.
httpAuthorization: Bearer sk-your-api-keyДля совместимости с Anthropic SDK также поддерживается заголовок x-api-key.
httpx-api-key: sk-your-api-keyBase URL
https://api.clavis.to/v1Замените base_url в любом OpenAI SDK — никаких других изменений не нужно.
Claude Code
Официальный CLI Anthropic для разработки с AI. Работает через Anthropic Messages API, совместимый с Clavis.to.
1. Установите Node.js
powershell (admin)# Через winget (встроен в Windows 10/11)
winget install OpenJS.NodeJS.LTS
# Проверка установки
node --version
npm --version2. Установите Claude Code CLI
powershell (admin)npm install -g @anthropic-ai/claude-code
# Проверка
claude --version3. Создайте API-ключ
Перейдите в Dashboard → API-ключи, нажмите «Создать», скопируйте ключ (показывается один раз).
4. Настройте конфигурацию
Файл конфигурации: %USERPROFILE%\.claude\settings.json
powershell# Создайте папку и файл
mkdir %USERPROFILE%\.claude
notepad %USERPROFILE%\.claude\settings.jsonjson{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-ваш-апи-ключ",
"ANTHROPIC_BASE_URL": "https://api.clavis.to",
"API_TIMEOUT_MS": "600000"
}
}5. Запустите Claude Code
cmdcd ваш-проект
claudeOpenAI CodeX
Корпоративный AI-помощник для программирования от OpenAI. Поддерживает агентный режим и поиск в сети.
1. Установите CodeX CLI
powershell (admin)npm install -g @openai/codex@latest
codex --version2. Создайте файлы конфигурации
Создайте папку %USERPROFILE%\.codex\
config.toml
tomlmodel_provider = "clavis"
model = "gpt-4.1"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
[model_providers.clavis]
name = "clavis"
base_url = "https://api.clavis.to/v1"
wire_api = "responses"
requires_openai_auth = trueauth.json
json{
"OPENAI_API_KEY": "sk-ваш-апи-ключ"
}3. Запустите CodeX
cmdcd ваш-проект
codexGemini CLI
AI-помощник от Google с контекстным окном 1M токенов, агентным режимом и поиском в интернете.
1. Установите Gemini CLI
powershellnpm install -g @google/gemini-cli
gemini --version2. Создайте конфигурацию
Создайте папку %USERPROFILE%\.gemini\
.env
envGOOGLE_GEMINI_BASE_URL=https://api.clavis.to
GEMINI_API_KEY=sk-ваш-апи-ключ
GEMINI_MODEL=gemini-2.5-prosettings.json
json{
"security": {
"auth": { "selectedType": "gemini-api-key" }
}
}3. Запустите
cmdgeminiSillyTavern
Мощная платформа для создания историй с поддержкой OpenAI и Claude (Native Anthropic).
1. Установите SillyTavern
Скачайте и установите с GitHub. Запустите start.bat (Windows) или start.sh (macOS/Linux).
2. Настройте API
Откройте браузер http://localhost:8000 → кнопка «API» → выберите «Claude» (Anthropic Native):
https://api.clavis.to/v1sk-ваш-апи-ключCherry Studio
Многофункциональный десктопный AI-ассистент для Windows / macOS / Linux.
Настройка API
Откройте Cherry Studio → Настройки → Провайдеры моделей → Добавить → OpenAI:
https://api.clavis.tosk-ваш-апи-ключРекомендуемые модели
claude-sonnet-4-6
gpt-4o
gemini-2.5-proChat Completions
/v1/chat/completionsСоздать завершение чата (OpenAI-совместимо)
Параметры запроса
model*stringID модели из /v1/modelsmessages*arrayМассив сообщений [{role, content}]streambooleanВключить SSE-стриминг (по умолчанию false)max_tokensintegerМаксимум токенов в ответеtemperaturenumber0.0 – 2.0Пример
bashcurl https://api.clavis.to/v1/chat/completions \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"stream": true,
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Explain async/await in Python"}
]
}'Models
/v1/modelsСписок всех активных моделей (без авторизации)
/v1/models/:model_idИнформация о конкретной модели
Пример ответа
json{
"object": "list",
"data": [
{
"id": "gpt-4o",
"owned_by": "OpenAI",
"billing_type": "per_token",
"pricing": {
"input_per_1m_rub": 43.75,
"output_per_1m_rub": 131.25
},
"context_window": 128000,
"endpoints": ["openai"],
"is_active": true
}
]
}Anthropic Messages API
/v1/messagesAnthropic-совместимый эндпоинт (для Claude SDK и Claude Code)
Поддерживает заголовок x-api-key (формат Anthropic SDK). Внутри конвертирует запрос в формат OpenAI и обратно.
Пример
pythonimport anthropic
client = anthropic.Anthropic(
api_key="sk-ваш-апи-ключ",
base_url="https://api.clavis.to",
)
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}]
)
print(message.content[0].text)Embeddings
/v1/embeddingsСоздать текстовые эмбеддинги
Пример
bashcurl https://api.clavis.to/v1/embeddings \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{
"model": "text-embedding-3-small",
"input": "The quick brown fox"
}'Image Generation
/v1/images/generationsГенерация изображений (DALL·E, Flux)
Пример
bashcurl https://api.clavis.to/v1/images/generations \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{
"model": "dall-e-3",
"prompt": "A sunset over mountains",
"n": 1,
"size": "1024x1024"
}'Биллинг и тарификация
Стоимость списывается после завершения каждого запроса на основе реально использованных токенов.
Per-token
Оплата за входные и выходные токены
Per-request
Фиксированная цена за запрос (изображения, TTS)
Рубли
Все цены в рублях, пополнение через Russian payment methods
Актуальные цены на все модели доступны на странице /models.
Обработка ошибок
API возвращает стандартные HTTP-коды. Тело ошибки в формате OpenAI:
json{
"error": {
"message": "Insufficient balance. Please add credits.",
"type": "payment_error",
"code": 402
}
}invalid_request_errorНеверные параметры запросаauthentication_errorНеверный или отсутствующий API-ключpayment_errorНедостаточно средств на балансеnot_found_errorМодель не найдена или отключенаrate_limit_errorСлишком много одновременных запросовserver_errorВнутренняя ошибка — повторите запрос