Весело
Весело

Ключи и авторизация

Ключ 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 токенов ответа и может не пройти даже в начале месяца. Подробнее — Цены и списания.

Ошибки ключа

HTTPcodeКогда
401missing_api_keyключа нет в запросе
401invalid_api_keyключ с ошибкой, отозван или не найден
403account_blockedаккаунт заблокирован — не работает ни один его ключ
403key_limit_reachedзапрос не помещается в месячный лимит ключа

Безопасность

  • Храни ключ в переменной окружения или хранилище секретов, не в коде. Не коммить его в git.
  • Не вставляй ключ в код сайта или мобильного приложения: его увидит любой. Зови API со своего сервера.
  • Заводи отдельный ключ на каждую программу и ИИ-агента: так видно, кто сколько тратит, и отозвать можно точечно.
  • Ставь месячный лимит ключам, которые отдаёшь агентам и скриптам.
  • Ключ утёк — отзови его в кабинете и выпусти новый.
  • В журналах нашего сервера ключ вырезается.

← Быстрый старт · Цены и списания →

Вся документация одним текстом · Все модели и цены