Как передать ключ своей нейросети
Как подключить API Весело к ИИ-агенту или помощнику в коде: готовый текст для нейросети, вся документация в llms.txt, отдельный ключ с лимитом.
Обновлено:
Если помощнику нужно самому снимать видео, рисовать и спрашивать модели — ключ не нужен: подключи MCP-сервер без ключа, вход — кнопкой «Разрешить» на veselo.ai. Ключ нужен, когда помощник пишет программу, которая будет звать API сама.
ИИ-агенты и помощники в коде — Claude Code, Cursor, Codex, Cline — могут сами написать программу, которая зовёт API. Им нужны три вещи: адрес, ключ и документация.
- Выпусти для агента отдельный ключ в кабинете и поставь ему месячный лимит, например 300 ₽. Агент может ошибиться и зациклить запросы — лимит ограничит траты.
- Положи ключ в переменную окружения
VESELO_API_KEYтам, где агент запускает код. В сам чат ключ не вставляй. - Дай агенту текст ниже: в нём адрес, правила и ссылка на документацию.
Текст для нейросети
Подключи API Весело — нейросети по API за рубли в формате OpenAI Chat Completions.
Адрес: https://veselo.ai/v1 (POST /chat/completions, GET /models, GET /balance, GET /usage).
Ключ лежит в переменной окружения VESELO_API_KEY. Передавай его в заголовке Authorization: Bearer.
Не печатай ключ и не сохраняй его в файлах проекта.
Вся документация одним файлом: https://veselo.ai/docs/llms.txt — прочитай её перед работой.
Модель по умолчанию — deepseek/deepseek-v4.1-flash-ultrafast, другие — GET https://veselo.ai/v1/models.
Каждый запрос платный: ставь max_tokens, цену бери из usage.cost_rub, остаток — GET https://veselo.ai/v1/balance.
Ошибки 429 и 5xx повторяй с паузой (заголовок Retry-After), остальные 4xx не повторяй.Документация для ИИ
Вся документация одним текстом в Markdown — veselo.ai/docs/llms.txt. Отдай ссылку агенту или скачай файл и приложи к запросу. У каждого раздела на сайте есть кнопка «Скопировать для ИИ» — раздел целиком в Markdown.
Описание методов в формате OpenAPI 3.1 — GET https://veselo.ai/v1/openapi.json, без ключа: его понимают генераторы клиентов и Postman.
Нейросеть сама зовёт модели
Если нужно, чтобы помощник сам спрашивал другие модели, смотрел цены и баланс, подключи MCP-сервер — код писать не нужно.
Шпаргалка для агента
- Формат — OpenAI Chat Completions: SDK OpenAI работают с
base_urlhttps://veselo.ai/v1. Responses API, эмбеддингов и Batch API нет. - Формат Anthropic Messages —
POST /messages: SDK Anthropic работают сbase_urlhttps://veselo.ai, без/v1. Моделей Claude нет — модели те же, что у чата: текстовые изGET /models. - Ключ —
Authorization: Bearer sk-vsl-…. Без ключа работают толькоGET /modelsиGET /openapi.json. - id модели — вида
vendor/model, только изGET /models. n— только 1. Поля, которых нет в справочнике, отбрасываются.- Удержание — по
max_tokens, без него — до 16 384 токенов ответа. Ставьmax_tokens. - Цена —
usage.cost_rub(в потоке — в последнем куске) и заголовокx-veselo-cost-rub. - Ошибки —
{"error": {"message", "type", "code", "param", "request_id"}}. 402 — не хватает денег (required_rub,available_rub), 429 — подождиRetry-Afterсекунд. - Лимиты — 60 запросов в минуту и 10 одновременных на ключ, тело — до 25 МБ.
- Стриминг — SSE; конец —
data: [DONE]; ошибка посреди потока — кусок сerror. - Без стриминга ставь тайм-аут клиента не меньше 5 минут: запрос дорабатывает и оплачивается, даже если клиент отключился.