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

Как передать ключ своей нейросети

Как подключить API Весело к ИИ-агенту или помощнику в коде: готовый текст для нейросети, вся документация в llms.txt, отдельный ключ с лимитом.

Обновлено:

Если помощнику нужно самому снимать видео, рисовать и спрашивать модели — ключ не нужен: подключи MCP-сервер без ключа, вход — кнопкой «Разрешить» на veselo.ai. Ключ нужен, когда помощник пишет программу, которая будет звать API сама.

ИИ-агенты и помощники в коде — Claude Code, Cursor, Codex, Cline — могут сами написать программу, которая зовёт API. Им нужны три вещи: адрес, ключ и документация.

  1. Выпусти для агента отдельный ключ в кабинете и поставь ему месячный лимит, например 300 ₽. Агент может ошибиться и зациклить запросы — лимит ограничит траты.
  2. Положи ключ в переменную окружения VESELO_API_KEY там, где агент запускает код. В сам чат ключ не вставляй.
  3. Дай агенту текст ниже: в нём адрес, правила и ссылка на документацию.

Текст для нейросети

Подключи 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_url https://veselo.ai/v1. Responses API, эмбеддингов и Batch API нет.
  • Формат Anthropic Messages — POST /messages: SDK Anthropic работают с base_url https://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 минут: запрос дорабатывает и оплачивается, даже если клиент отключился.

← Claude Code · MCP →

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