---
title: "Как передать ключ своей нейросети"
description: "Как подключить API Весело к ИИ-агенту или помощнику в коде: готовый текст для нейросети, вся документация в llms.txt, отдельный ключ с лимитом."
url: https://veselo.ai/docs/agents
updated: 2026-11-14T20:55:06.831Z
---

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

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

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

> Если помощнику нужно самому снимать видео, рисовать и спрашивать модели — ключ не нужен: подключи [MCP-сервер без ключа](https://veselo.ai/docs/mcp#no-key), вход — кнопкой «Разрешить» на veselo.ai. Ключ нужен, когда помощник пишет программу, которая будет звать API сама.

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

1. Выпусти для агента отдельный ключ в [кабинете](https://veselo.ai/developer) и поставь ему месячный лимит, например 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](https://veselo.ai/docs/llms.txt). Отдай ссылку агенту или скачай файл и приложи к запросу. У каждого раздела на сайте есть кнопка «Скопировать для ИИ» — раздел целиком в Markdown.

Описание методов в формате OpenAPI 3.1 — `GET https://veselo.ai/v1/openapi.json`, без ключа: его понимают генераторы клиентов и Postman.

## Нейросеть сама зовёт модели

Если нужно, чтобы помощник сам спрашивал другие модели, смотрел цены и баланс, подключи [MCP-сервер](https://veselo.ai/docs/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. Поля, которых нет в [справочнике](https://veselo.ai/docs/reference#chat), отбрасываются.
- Удержание — по `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](https://veselo.ai/docs/anthropic) · [MCP →](https://veselo.ai/docs/mcp)

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

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

### Начало

- [Быстрый старт](https://veselo.ai/docs)
- [Ключи](https://veselo.ai/docs/auth)
- [Цены и списания](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)
- **Ключ для нейросети**
- [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)
