Документация API

OpenAI-совместимый API для доступа к 80+ языковым моделям. Оплата в рублях, без VPN.

Быстрый старт

Clavis.to — единый OpenAI-совместимый API для 80+ нейросетей. Для начала нужен только API-ключ.

1

Создайте аккаунт

Зарегистрируйтесь на clavis.to

2

Пополните баланс

Оплата в рублях, от 100₽

3

Создайте API-ключ

Dashboard → API-ключи

4

Отправьте запрос

Любой 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-key

Base 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 --version
Также можно скачать установщик .msi с nodejs.org → LTS версия.

2. Установите Claude Code CLI

powershell (admin)npm install -g @anthropic-ai/claude-code

# Проверка
claude --version

3. Создайте API-ключ

Перейдите в Dashboard → API-ключи, нажмите «Создать», скопируйте ключ (показывается один раз).

4. Настройте конфигурацию

Файл конфигурации: %USERPROFILE%\.claude\settings.json

powershell# Создайте папку и файл
mkdir %USERPROFILE%\.claude
notepad %USERPROFILE%\.claude\settings.json
json{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-ваш-апи-ключ",
    "ANTHROPIC_BASE_URL": "https://api.clavis.to",
    "API_TIMEOUT_MS": "600000"
  }
}
⚠️ Замените sk-ваш-апи-ключ на ключ из вашего Dashboard → API-ключи.

5. Запустите Claude Code

cmdcd ваш-проект
claude

OpenAI CodeX

Корпоративный AI-помощник для программирования от OpenAI. Поддерживает агентный режим и поиск в сети.

1. Установите CodeX CLI

powershell (admin)npm install -g @openai/codex@latest
codex --version

2. Создайте файлы конфигурации

Создайте папку %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 = true

auth.json

json{
  "OPENAI_API_KEY": "sk-ваш-апи-ключ"
}

3. Запустите CodeX

cmdcd ваш-проект
codex

Gemini CLI

AI-помощник от Google с контекстным окном 1M токенов, агентным режимом и поиском в интернете.

1. Установите Gemini CLI

powershellnpm install -g @google/gemini-cli
gemini --version

2. Создайте конфигурацию

Создайте папку %USERPROFILE%\.gemini\

.env

envGOOGLE_GEMINI_BASE_URL=https://api.clavis.to
GEMINI_API_KEY=sk-ваш-апи-ключ
GEMINI_MODEL=gemini-2.5-pro

settings.json

json{
  "security": {
    "auth": { "selectedType": "gemini-api-key" }
  }
}

3. Запустите

cmdgemini

SillyTavern

Мощная платформа для создания историй с поддержкой OpenAI и Claude (Native Anthropic).

1. Установите SillyTavern

Скачайте и установите с GitHub. Запустите start.bat (Windows) или start.sh (macOS/Linux).

2. Настройте API

Откройте браузер http://localhost:8000 → кнопка «API» → выберите «Claude» (Anthropic Native):

Claude API URLhttps://api.clavis.to/v1
API Keysk-ваш-апи-ключ
Если получаете ошибку 400 Bad Request — установите Top_P = 0 в настройках AI Response Configuration.

Cherry Studio

Многофункциональный десктопный AI-ассистент для Windows / macOS / Linux.

Настройка API

Откройте Cherry Studio → Настройки → Провайдеры моделей → Добавить → OpenAI:

API URLhttps://api.clavis.to
API Keysk-ваш-апи-ключ

Рекомендуемые модели

claude-sonnet-4-6
gpt-4o
gemini-2.5-pro

Chat Completions

POST/v1/chat/completions

Создать завершение чата (OpenAI-совместимо)

Параметры запроса

model*stringID модели из /v1/models
messages*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

GET/v1/models

Список всех активных моделей (без авторизации)

GET/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

POST/v1/messages

Anthropic-совместимый эндпоинт (для 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

POST/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

POST/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
  }
}
400invalid_request_errorНеверные параметры запроса
401authentication_errorНеверный или отсутствующий API-ключ
402payment_errorНедостаточно средств на балансе
404not_found_errorМодель не найдена или отключена
429rate_limit_errorСлишком много одновременных запросов
500server_errorВнутренняя ошибка — повторите запрос