---
title: "Ключи и авторизация"
description: "Ключ API Весело: где выпустить, как передать в заголовке Authorization, месячный лимит расхода, отзыв ключа и правила безопасности."
url: https://veselo.ai/docs/auth
updated: 2026-11-12T23:25:43.224Z
---

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

Ключ API Весело: где выпустить, как передать в заголовке Authorization, месячный лимит расхода, отзыв ключа и правила безопасности.

Обновлено: 13 ноября 2026 г.

Каждый запрос к API подписывается ключом. Ключ выглядит так: `sk-vsl-` и ещё 43 латинские буквы и цифры. Выпускается в кабинете [veselo.ai/developer](https://veselo.ai/developer).

> ИИ-помощнику — Claude, Claude Code, Cursor, VS Code — ключ не нужен: он подключается к [MCP-серверу](https://veselo.ai/docs/mcp#no-key), а ты входишь на 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 — ключа нет, он с ошибкой или отозван; что в ответе, описано в разделе [Справочник](https://veselo.ai/docs/reference#balance).

## Как устроены ключи

- Ключ целиком показывается при выпуске. Посмотреть его снова можно в [кабинете](https://veselo.ai/developer): значок глаза у ключа, код подтверждения придёт в чат с ботом (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 токенов ответа и может не пройти даже в начале месяца. Подробнее — [Цены и списания](https://veselo.ai/docs/pricing#hold).

## Ошибки ключа

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

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

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

[← Быстрый старт](https://veselo.ai/docs) · [Цены и списания →](https://veselo.ai/docs/pricing)

[Вся документация одним текстом](https://veselo.ai/docs/llms.txt) · [Все модели и цены](https://veselo.ai/models)

## Разделы документации

### Начало

- [Быстрый старт](https://veselo.ai/docs)
- **Ключи**
- [Цены и списания](https://veselo.ai/docs/pricing)
- [Модели](https://veselo.ai/docs/models)

### Как сделать

- [Сообщения и параметры](https://veselo.ai/docs/chat)
- [Стриминг](https://veselo.ai/docs/streaming)
- [Вызов функций](https://veselo.ai/docs/tools)
- [Ответ в JSON](https://veselo.ai/docs/structured-output)
- [Провайдеры](https://veselo.ai/docs/providers)
- [Без цензуры](https://veselo.ai/docs/uncensored)
- [Картинки во входе](https://veselo.ai/docs/vision)
- [Картинки](https://veselo.ai/docs/images)
- [Видео](https://veselo.ai/docs/video)
- [Озвучка](https://veselo.ai/docs/speech)
- [Музыка](https://veselo.ai/docs/music)
- [SDK и программы](https://veselo.ai/docs/sdks)
- [Claude Code](https://veselo.ai/docs/anthropic)
- [Ключ для нейросети](https://veselo.ai/docs/agents)
- [MCP](https://veselo.ai/docs/mcp)

### Справочник

- [Методы API](https://veselo.ai/docs/reference)
- [Ошибки](https://veselo.ai/docs/errors)
- [Лимиты](https://veselo.ai/docs/limits)
- [Заголовки](https://veselo.ai/docs/headers)

### Ещё

- [Вопросы](https://veselo.ai/docs/faq)
- [Данные и приватность](https://veselo.ai/docs/privacy)
- [Изменения](https://veselo.ai/docs/changelog)
