Документация
Как пользоваться apitun.ru
Шлюз к языковым моделям (GPT, Claude, Gemini и другие — актуальный список смотрите на вкладке «Тарифы») с оплатой в рублях. Один аккаунт даёт чат прямо в браузере и API-ключ для подключения моделей из своего кода — оба способа списывают деньги с одного баланса по одним тарифам.
| Адрес | Что это | Кому нужен |
|---|---|---|
| apitun.ru | Личный кабинет | Всем — вход, оплата, ключи, чат |
| apitun.ru/api/… | Служебный backend сайта | Только самому сайту, руками не нужен |
| llm.apitun.ru | Сам шлюз к моделям | Ваш код — по API-ключу |
01Быстрый старт
- Зарегистрируйтесь на apitun.ru/register и подтвердите почту по ссылке из письма.
- Пополните баланс на вкладке «Пополнить».
- Создайте API-ключ на вкладке «Ключи» — он нужен и для чата, и для API.
- Пользуйтесь чатом в кабинете или подключите свой код к
https://llm.apitun.ru/v1.
02Регистрация и вход
На странице регистрации укажите email и пароль (не короче 8 символов), примите условия публичной оферты и согласие на обработку персональных данных — без этого форма не отправится.
Забыли пароль — форма восстановления на /forgot-password, письмо со ссылкой на сброс. Сменить пароль, зная текущий, можно на вкладке «Настройки».
03Личный кабинет
Разделы боковой навигации после входа
Обзор
Баланс, траты, график по дням, топ моделей
Пополнить
Покупка кредитов
Ключи
Создание и управление API-ключами
Тарифы
Цена каждой модели в кредитах
История
Все пополнения и списания
Настройки
Email, ID пользователя, смена пароля
Чат живёт отдельно, на /chat — кнопка «💬 Чат с ИИ» есть на «Обзоре».
04Оплата и баланс
Оплата — в рублях, зачисление — в кредитах, курс фиксированный: 1 ₽ = 1 кредит. Вся тарификация в кабинете дальше указана в кредитах.
| Пакет | Бонус |
|---|---|
| 500 ₽ | — |
| 1 000 ₽ | +5% |
| 3 000 ₽ | +10% |
| 10 000 ₽ | +15% |
Своя сумма — от 10 до 500 000 ₽, целое число.
Оплата проходит через ЮKassa: после выбора суммы вас переносит на страницу оплаты, после оплаты — обратно в кабинет, где статус проверяется автоматически (обычно несколько секунд). Если статус завис — баланс всё равно обновится сам в течение нескольких минут. Все операции видны на вкладке «История».
05API-ключи
Ключ — это то, чем авторизуются запросы к моделям, будь то чат в кабинете или собственный код. У одного аккаунта — до 5 активных ключей одновременно (отключённые в лимит не входят).
Создание
- Вкладка «Ключи» → «+ Создать ключ», укажите название.
- Если у вашей группы настроены карточки лимитов (запросов/минуту, токенов/минуту, параллельных запросов) — выберите одну. Лимиты фиксируются в момент создания и меняются только пересозданием ключа с другой карточкой.
Управление
- Отключить — ключ перестаёт работать, но остаётся в списке; можно включить обратно.
- Включить — вернуть отключённый ключ в работу.
- Удалить навсегда — только для уже отключённого ключа, необратимо.
Статусы (кнопка «Получить актуальные данные»)
- Остановлен — нулевой/отрицательный баланс, пополните счёт
- В лимите — недавняя ошибка 429, подождите до следующей минуты
- Работает — всё в порядке
Счётчик «429 сегодня» — сколько раз за сутки ключ отклонялся по лимиту скорости; если он стабильно растёт, создайте ключ с карточкой лимитов попросторнее.
06Тарифы
Вкладка «Тарифы» показывает цену каждой доступной модели за 1 000 000 токенов, в кредитах — отдельно на входящие, исходящие токены и промпт-кэширование (чтение/запись) для моделей, которые его поддерживают. Цены уже включают наценку платформы, дополнительных комиссий нет.
07Чат в личном кабинете
/chat — полноценный чат прямо в браузере: список диалогов слева (поиск, закрепление, переименование, удаление), окно переписки справа, ответ приходит потоково.
Перед отправкой сообщения выберите вверху окна:
- ключ — каким из ваших API-ключей списывать запрос;
- модель — какую модель использовать.
Оба выбора запоминаются и подставляются в следующий раз; их можно сменить прямо посреди диалога.
⏹ Стоп
Прервать генерацию
⟳ Повторить
Перегенерировать ответ
⧉ Копировать
Скопировать текст
🗑 Удалить
Сообщение или весь чат
Если баланс закончился во время ответа — придёт сообщение об ошибке с кнопкой «Пополнить баланс» прямо в переписке. Списание в чате — по тем же тарифам, что и через API, отдельного тарифа для чата нет. Без единого ключа чат подскажет создать его на вкладке «Ключи».
08Подключение по API
Нужны две вещи: ваш sk-... ключ и адрес шлюза:
base_url = https://llm.apitun.ru/v1Дальше всё работает как со стандартным OpenAI SDK — просто указываете свой ключ и этот base_url.
Список доступных моделей
GET https://llm.apitun.ru/v1/models
Authorization: Bearer sk-ваш-ключИдентификаторы моделей совпадают с тем, что видно в чате кабинета и на вкладке «Тарифы».
Запрос к модели
curl https://llm.apitun.ru/v1/chat/completions \
-H "Authorization: Bearer sk-ваш-ключ" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o-mini",
"messages": [{"role": "user", "content": "Привет! Это тестовый запрос."}]
}'Python (openai SDK):
from openai import OpenAI
client = OpenAI(
api_key="sk-ваш-ключ",
base_url="https://llm.apitun.ru/v1",
)
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[{"role": "user", "content": "Привет! Это тестовый запрос."}],
)
print(response.choices[0].message.content)Стриминг — обычный параметр "stream": true в теле запроса (или stream=True в SDK), как в стандартном OpenAI API. Списание идёт с того же баланса, что и чат в кабинете, по тем же тарифам, и ограничено теми же лимитами скорости, что заданы карточкой лимитов у ключа.
09Подключение кодовых агентов
llm.apitun.ru — это работающий напрямую LiteLLM proxy, поэтому кроме обычного OpenAI-совместимого API он умеет и протокол Anthropic (/v1/messages) — его используют кодовые агенты вроде Claude Code. Ключ везде тот же sk-... из раздела «API-ключи», модель — любой идентификатор с вкладки «Тарифы».
Claude Code
export ANTHROPIC_BASE_URL="https://llm.apitun.ru"
export ANTHROPIC_AUTH_TOKEN="sk-ваш-ключ"
# опционально — сразу выбрать модель, иначе Claude Code сам подтянет
# список через GET /v1/models и даст выбрать командой /model
export ANTHROPIC_MODEL="claude-sonnet-5"ANTHROPIC_BASE_URL — без /v1 в конце (в отличие от base_url для OpenAI SDK выше). Claude Code сам обращается к /v1/messages — это отдельный протокол, шлюз переводит запрос в нужную модель автоматически.OpenCode
Конфиг opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"apitun": {
"npm": "@ai-sdk/openai-compatible",
"name": "apitun.ru",
"options": { "baseURL": "https://llm.apitun.ru/v1", "apiKey": "sk-ваш-ключ" },
"models": { "gpt-4o-mini": { "name": "GPT-4o mini" } }
}
}
}Hermes Agent
Команда hermes model → «custom OpenAI-compatible endpoint» → указать base_url (https://llm.apitun.ru/v1), api_key и имя модели. То же самое можно прописать сразу в конфиг-файле: provider: custom, base_url, api_key.
OpenClaw
Конфиг (json5):
{
models: {
providers: {
openai: {
baseUrl: "https://llm.apitun.ru/v1",
apiKey: "sk-ваш-ключ",
},
},
},
agents: { defaults: { model: { primary: "openai/gpt-4o-mini" } } },
}10Cherry Studio
- Настройки (шестерёнка в боковой панели) → вкладка «Model Services».
- «+ Add» под списком провайдеров → тип провайдера OpenAI.
- API address:
https://llm.apitun.ru/v1. - API key: ваш
sk-...ключ. - «+ Add» в разделе моделей — вручную впишите id модели (список — на вкладке «Тарифы»), автоопределения моделей нет.
- Кнопка «Check» — проверить, что ключ и адрес рабочие.
11Как протестировать подключение
- Проверьте список моделей —
GET /v1/modelsс вашим ключом должен вернуть непустой список без ошибки авторизации. - Отправьте один короткий запрос на
/v1/chat/completions— должен прийти обычный ответ модели. - Если что-то не так — тот же ключ и модель, скорее всего, работают в чате кабинета: если чат отвечает, а прямой запрос нет — проблема в коде клиента (заголовок авторизации,
base_url, формат тела запроса), а не в ключе или балансе. - На вкладке «Ключи» кнопка «Получить актуальные данные» покажет, не остановлен ли ключ из-за баланса и не упирается ли в лимит скорости — это первое, что стоит проверить при сбоях.
12Частые ошибки
| Симптом | Причина | Что делать |
|---|---|---|
| 401 Unauthorized | Неверный или отключённый ключ | Проверьте, что ключ скопирован полностью; на «Ключах» убедитесь, что он «Активен» |
| 429 Too Many Requests | Упёрлись в лимит скорости карточки ключа | Подождите до следующей минуты или создайте ключ с карточкой попросторнее |
| «Недостаточно средств» | Баланс закончился (может уйти в минус) | Пополните баланс на вкладке «Пополнить» |
| Не подключается к llm.apitun.ru | Опечатка в адресе — отдельный домен от apitun.ru | Используйте ровно https://llm.apitun.ru/v1 как base_url |
Актуальный источник истины — сам кабинет на apitun.ru и вкладка «Тарифы» для цен.