Ключи и авторизация
Ключ API Весело: где выпустить, как передать в заголовке Authorization, месячный лимит расхода, отзыв ключа и правила безопасности.
Обновлено:
Каждый запрос к API подписывается ключом. Ключ выглядит так: sk-vsl- и ещё 43 латинские буквы и цифры. Выпускается в кабинете veselo.ai/developer.
ИИ-помощнику — Claude, Claude Code, Cursor, VS Code — ключ не нужен: он подключается к MCP-серверу, а ты входишь на veselo.ai и нажимаешь «Разрешить».
Как передать ключ
В заголовке Authorization: Bearer sk-vsl-… — так делают SDK OpenAI и большинство программ. Если программа умеет только x-api-key, подойдёт и он: x-api-key: sk-vsl-…. Если переданы оба, берётся Authorization.
Проверить ключ проще всего запросом баланса — он бесплатный:
curl
curl https://veselo.ai/v1/balance -H "Authorization: Bearer $VESELO_API_KEY"Python
import os
import requests # pip install requests
r = requests.get(
"https://veselo.ai/v1/balance",
headers={"Authorization": f"Bearer {os.environ['VESELO_API_KEY']}"},
timeout=30,
)
print(r.status_code, r.json())JavaScript
const res = await fetch('https://veselo.ai/v1/balance', {
headers: { Authorization: `Bearer ${process.env.VESELO_API_KEY}` },
});
console.log(res.status, await res.json());Ответ 200 — ключ работает. 401 — ключа нет, он с ошибкой или отозван; что в ответе, описано в разделе Справочник.
Как устроены ключи
- Ключ целиком показывается при выпуске. Посмотреть его снова можно в кабинете: значок глаза у ключа, код подтверждения придёт в чат с ботом (Telegram, VK) или на почту для входа. Ключи, выпущенные до 8 ноября 2026 года, так не показать — только выпустить новый.
- В списке ключ узнаётся по имени, первым знакам и последним четырём.
- Действующих ключей — до 20, новых можно выпустить до 10 в час.
- Ключу можно задать месячный лимит расхода — от 1 до 1 000 000 ₽ или без лимита. Месяц считается по московскому времени.
- Отзыв срабатывает сразу: следующий запрос с отозванным ключом получит 401. Отозванный ключ не восстанавливается.
- Деньги у всех ключей общие — API-счёт аккаунта.
GET /v1/balanceиGET /v1/usageпоказывают баланс и расход всего аккаунта, а не одного ключа.
Месячный лимит ключа
Лимит защищает от лишних трат, если ключ утёк или программа зациклилась. Перед каждым запросом складываются: потраченное ключом за месяц, удержания его идущих запросов и удержание нового запроса. Если сумма больше лимита, ответ — 403 key_limit_reached с полями limit_rub и spent_rub.
Лимит сравнивается с удержанием — наибольшей ценой запроса, а не с фактической. При маленьком лимите ставь
max_tokens: без него запрос удерживает цену 16 384 токенов ответа и может не пройти даже в начале месяца. Подробнее — Цены и списания.
Ошибки ключа
| HTTP | code | Когда |
|---|---|---|
| 401 | missing_api_key | ключа нет в запросе |
| 401 | invalid_api_key | ключ с ошибкой, отозван или не найден |
| 403 | account_blocked | аккаунт заблокирован — не работает ни один его ключ |
| 403 | key_limit_reached | запрос не помещается в месячный лимит ключа |
Безопасность
- Храни ключ в переменной окружения или хранилище секретов, не в коде. Не коммить его в git.
- Не вставляй ключ в код сайта или мобильного приложения: его увидит любой. Зови API со своего сервера.
- Заводи отдельный ключ на каждую программу и ИИ-агента: так видно, кто сколько тратит, и отозвать можно точечно.
- Ставь месячный лимит ключам, которые отдаёшь агентам и скриптам.
- Ключ утёк — отзови его в кабинете и выпусти новый.
- В журналах нашего сервера ключ вырезается.