Telegram-бот с нейросетью на TypeScript в 145 строк: картинка за 0,69 ₽, а одна команда — почти в 70 раз дороже
Случайный человек, нашедший вашего Telegram-бота, может потратить 47,95 ₽ с вашего баланса одним словом. Команда /animate превращает картинку в 5-секундный ролик Kling 2.6, и он стоит почти как 70 картинок FLUX 2 Flash. Ниже — 145 строк TypeScript: бот рисует за 0,69 ₽, правит фото и оживляет их, а белый список и дневной лимит уже встроены.
Что умеет бот
Три команды, три модели, один ключ API:
1. Текст превращается в картинку. «керамическая кружка на мокром подоконнике, плёночное фото» уходит в FLUX 2 Flash в размере 1024×768 и возвращается в чат фотографией.
2. Фото с подписью превращается в правку. Пришлите снимок с подписью «замени фон на солнечный пляж» — FLUX 2 Edit вернёт изменённую картинку.
3. /animate превращается в ролик. Ответьте /animate на любую картинку бота, можно с описанием движения («/animate над кружкой поднимается пар, медленный наезд камеры»), и Kling 2.6 Pro сделает из неё видео на 5 секунд.
Ни фреймворка, ни сервера, ни базы: в Node 20 уже есть fetch, FormData и Blob, а long polling в Telegram позволяет запустить бота хоть на ноутбуке, без публичного адреса.
Сколько стоит каждая команда
Цены — со страниц моделей Пионер ИИ-шлюза. Деньги списываются, когда задача встаёт в очередь, а если модель не справилась, возвращаются на баланс.
| Команда | Модель | Настройки | Цена |
|---|---|---|---|
| Текст | FLUX 2 Flash | landscape_4_3 (1024×768, 1 начатый мегапиксель), jpeg | 0,69 ₽ |
| Фото с подписью | FLUX 2 Edit | вход не больше 1 мегапикселя, результат повторяет размер входа | 3,28 ₽ (1 Мп на входе + 1 Мп на выходе по 1,64 ₽) |
| /animate | Kling 2.6 Pro, изображение в видео | duration "5", generate_audio false | 47,95 ₽ |
| /animate со звуком | Kling 2.6 Pro, изображение в видео | duration "5", generate_audio true (по умолчанию) | 95,90 ₽ |
Один ролик стоит почти как 70 картинок. Команда из 5 человек, где каждый делает в день 20 картинок и 1 ролик, тратит за месяц 2 070 ₽ на 3 000 картинок и 7 192,50 ₽ на 150 роликов: ролики — 78% счёта. Лимиты ставьте на /animate, а не на картинки.
Код
Один файл, bot.mts. Он повторяет схему из документации по медиа-API: POST с полями модели на /queue/<id модели>, опрос status_url до COMPLETED или FAILED, затем результат из response_url. Цены для дневного лимита записаны в PRICE_RUB прямо в коде — обновите их, если цены на страницах моделей изменятся.
// bot.mts: Telegram-бот, который рисует, редактирует и оживляет картинки через API Пионер ИИ-шлюза.
// Текст -> FLUX 2 Flash. Фото с подписью -> FLUX 2 Edit. Ответ /animate -> ролик Kling 2.6.
// Запуск: npx tsx bot.mts (Node 20+, без зависимостей)
const TG = "https://api.telegram.org/bot" + process.env.TELEGRAM_BOT_TOKEN;
const MB = "https://pioneerlabs.ru/api/gateway/v1";
const AUTH = { Authorization: "Bearer " + process.env.PIONEER_API_KEY };
const ALLOWED = (process.env.ALLOWED_USER_IDS ?? "").split(",").filter(Boolean);
const DAILY_CAP_RUB = Number(process.env.DAILY_CAP_RUB ?? "100");
// Цены со страниц моделей; FLUX 2 Edit: 1 Мп на входе + 1 Мп на выходе
const PRICE_RUB: Record<string, number> = {
"flux-2/flash": 0.69,
"flux-2/edit": 3.28,
"kling-video/v2.6/pro/image-to-video": 47.95,
};
const spent = new Map<string, number>(); // "userId:YYYY-MM-DD" -> рубли
const imageOf = new Map<number, string>(); // message_id бота -> URL картинки для /animate
async function tg(method: string, body: Record<string, unknown> | FormData) {
const isForm = body instanceof FormData;
const r = await fetch(TG + "/" + method, {
method: "POST",
headers: isForm ? undefined : { "Content-Type": "application/json" },
body: isForm ? body : JSON.stringify(body),
});
const json = await r.json();
if (!json.ok) throw new Error(method + ": " + json.description);
return json.result;
}
// Ставит задачу в очередь Пионер ИИ-шлюза, ждёт её и возвращает результат модели.
async function generate(model: string, input: Record<string, unknown>, userId: string) {
const key = userId + ":" + new Date().toISOString().slice(0, 10);
if ((spent.get(key) ?? 0) >= DAILY_CAP_RUB) throw new Error("Дневной лимит исчерпан.");
const r = await fetch(MB + "/queue/" + model, {
method: "POST",
headers: { ...AUTH, "Content-Type": "application/json" },
body: JSON.stringify(input),
});
// 400 — лишнее поле, 402 — не хватает баланса, 422 — модель отклонила вход (не списывается)
if (!r.ok) throw new Error(model + ": HTTP " + r.status + " " + (await r.text()));
const job = await r.json();
spent.set(key, (spent.get(key) ?? 0) + (PRICE_RUB[model] ?? 0));
for (;;) {
await new Promise(res => setTimeout(res, 3000));
const { status } = await (await fetch(job.status_url, { headers: AUTH })).json();
if (status === "COMPLETED") break;
if (status === "FAILED") throw new Error("Генерация не удалась, деньги вернулись на баланс.");
}
return (await fetch(job.response_url, { headers: AUTH })).json();
}
// Скачивает готовый файл и загружает в чат (multipart: фото до 10 МБ, видео до 50 МБ).
async function sendFile(chatId: number, kind: "photo" | "video", url: string, caption: string) {
const blob = await (await fetch(url)).blob();
const form = new FormData();
form.append("chat_id", String(chatId));
form.append("caption", caption.slice(0, 1024));
form.append(kind, blob, kind === "photo" ? "image.jpg" : "clip.mp4");
return tg(kind === "photo" ? "sendPhoto" : "sendVideo", form);
}
// Берёт самую большую копию фото не больше 1 мегапикселя, скачивает её на своей стороне
// (в ссылке Telegram есть токен бота) и передаёт модели как data: URL.
async function photoAsDataUrl(sizes: { file_id: string; width: number; height: number }[]) {
const fit = sizes.filter(s => s.width * s.height <= 1_000_000);
const best = (fit.length ? fit : sizes.slice(0, 1)).at(-1)!;
const file = await tg("getFile", { file_id: best.file_id });
const bytes = await (
await fetch("https://api.telegram.org/file/bot" + process.env.TELEGRAM_BOT_TOKEN + "/" + file.file_path)
).arrayBuffer();
return "data:image/jpeg;base64," + Buffer.from(bytes).toString("base64");
}
async function handle(msg: any) {
const chatId: number = msg.chat.id;
const userId = String(msg.from?.id ?? "");
if (ALLOWED.length && !ALLOWED.includes(userId)) return; // чужие не тратят ваш баланс
const text: string = msg.text ?? msg.caption ?? "";
if (text.startsWith("/start")) {
await tg("sendMessage", {
chat_id: chatId,
text: "Пришлите описание — получите картинку. Пришлите фото с подписью — отредактирую. Ответьте /animate на мою картинку — сделаю ролик на 5 секунд.",
});
return;
}
if (text.startsWith("/animate")) {
const source = msg.reply_to_message && imageOf.get(msg.reply_to_message.message_id);
if (!source) {
await tg("sendMessage", { chat_id: chatId, text: "Ответьте /animate на картинку, которую сделал я." });
return;
}
await tg("sendChatAction", { chat_id: chatId, action: "upload_video" });
const motion = text.replace("/animate", "").trim() || "slow camera push-in, gentle natural motion";
const out = await generate(
"kling-video/v2.6/pro/image-to-video",
{ prompt: motion, start_image_url: source, duration: "5", generate_audio: false },
userId,
);
await sendFile(chatId, "video", out.video.url, "Kling 2.6 Pro, 5 с: 47,95 ₽");
return;
}
if (!text) return;
await tg("sendChatAction", { chat_id: chatId, action: "upload_photo" });
const out = msg.photo
? await generate(
"flux-2/edit",
{ prompt: text, image_urls: [await photoAsDataUrl(msg.photo)], output_format: "jpeg" },
userId,
)
: await generate(
"flux-2/flash",
{ prompt: text, image_size: "landscape_4_3", output_format: "jpeg" },
userId,
);
const url: string = out.images[0].url;
const sent = await sendFile(chatId, "photo", url, msg.photo ? "FLUX 2 Edit: 3,28 ₽" : "FLUX 2 Flash: 0,69 ₽");
imageOf.set(sent.message_id, url);
}
// Long polling: без сервера, вебхука и публичного адреса.
let offset = 0;
for (;;) {
try {
const updates = await tg("getUpdates", { offset, timeout: 50, allowed_updates: ["message"] });
for (const u of updates) {
offset = u.update_id + 1;
if (!u.message) continue;
handle(u.message).catch(err =>
tg("sendMessage", { chat_id: u.message.chat.id, text: String(err.message ?? err) }).catch(() => {}),
);
}
} catch (err) {
console.error(err);
await new Promise(res => setTimeout(res, 5000));
}
}Запуск
Создайте бота у @BotFather и скопируйте токен. Ключ Пионер ИИ-шлюза — на странице API-ключа в личном кабинете. Расширение .mts говорит Node, что файл — ES-модуль: это нужно для цикла опроса на верхнем уровне.
mkdir tg-image-bot && cd tg-image-bot
# сохраните код выше как bot.mts
export TELEGRAM_BOT_TOKEN="токен от @BotFather"
export PIONEER_API_KEY="ваш ключ Пионер ИИ-шлюза"
export ALLOWED_USER_IDS="123456789" # ваш id в Telegram; несколько — через запятую
export DAILY_CAP_RUB="100"
npx tsx bot.mtsЧтобы узнать свой id в Telegram, запустите бота с пустым ALLOWED_USER_IDS, напишите ему и один раз выведите msg.from.id в лог, затем пропишите переменную и перезапустите. На Node 22.6 и новее можно обойтись без tsx: node --experimental-strip-types bot.mts.
5 решений в коде, которые экономят деньги и нервы
1. Белый список — первым делом
Telegram-бот публичен: написать ему может любой, кто угадал @имя. Без ALLOWED_USER_IDS бот работает для всех — за ваш счёт. Проверка стоит в первой строке handle(), до вызова любой модели.
2. Дневной лимит в рублях
Перед каждой задачей бот сверяет траты пользователя за день с DAILY_CAP_RUB и прибавляет цену команды. Проверка идёт до задачи, поэтому последняя может перешагнуть лимит: при 100 ₽ пользователь получит за день 145 картинок или 3 ролика (143,85 ₽). Счётчик живёт в памяти и обнуляется при перезапуске; если это важно, храните его в файле или Redis.
3. Фото уходит модели как data: URL
Ссылки на файлы в Telegram выглядят как https://api.telegram.org/file/bot<token>/…, то есть отдать такую ссылку стороннему сервису — значит отдать токен бота. Бот сам скачивает фото (Telegram разрешает ботам скачивать файлы до 20 МБ) и отправляет его как base64 data: URL, который FLUX 2 Edit принимает в image_urls.
4. Входное фото — не больше 1 мегапикселя
FLUX 2 Edit считает каждый начатый мегапиксель результата и каждой входной картинки, а без image_size результат повторяет размер входа. Telegram присылает каждое фото в нескольких размерах (msg.photo), и бот берёт самый большой не больше 1 000 000 пикселей. Так правка стоит 2 мегапикселя, 3,28 ₽. Почему размер чуть больше миллиона пикселей удваивает счёт, разобрано в нашем гайде по промптам FLUX 2.
5. generate_audio: false в каждом ролике
Kling 2.6 Pro по умолчанию генерирует звук, а со звуком секунда стоит 19,18 ₽ вместо 9,59 ₽. Ролику для поста или сторис звук от модели обычно не нужен. Если пользователи попросят, сделайте отдельную команду /animate_sound и считайте её в лимите, как всё остальное.
Лимиты Telegram, под которые написан код
| Лимит | Значение | Что делает бот |
|---|---|---|
| Загрузка фото (multipart) | 10 МБ | Просит у FLUX jpeg, а не png по умолчанию |
| Фото по ссылке | 5 МБ | Загружает файл, а не передаёт ссылку |
| Загрузка видео | 50 МБ | Ролик на 5 секунд помещается с запасом |
| Скачивание файла ботом | 20 МБ | Берёт размер фото до 1 мегапикселя |
| Подпись | 1024 символа | Обрезает подпись через slice(0, 1024) |
| Действие в чате | показывается до 5 секунд | Отправляет upload_photo или upload_video |
Ошибки, которые увидят пользователи
Бот отправляет каждую ошибку в чат текстом, так что отлаживать можно с телефона. У медиа-API 4 ответа, которые стоит знать:
| Ответ | Что значит | Списывается? |
|---|---|---|
| HTTP 400 | Поле, которого модель не принимает, часто опечатка в названии | Нет |
| HTTP 402 | Баланса не хватает на задачу | Нет |
| HTTP 422 | Модель отклонила входные данные | Нет |
| Статус FAILED | Модель не справилась с задачей | Деньги возвращаются на баланс |
Если в общем боте посыпались 402, значит, лимит выше, чем вы пополняете баланс. Сначала снизьте DAILY_CAP_RUB, потом пополняйте — иначе пользователи потратят новый баланс в прежнем темпе.
Пусть бота напишет ИИ-агент
Если не хочется писать руками, вставьте этот промпт в Cursor, Claude Code или Codex — он описывает того же бота, плюс /help и команду /spent.
Напиши Telegram-бота в одном файле TypeScript, bot.mts, без зависимостей
(Node 20+, встроенные fetch и FormData), через long polling (getUpdates, timeout 50).
Медиа-API: base URL https://pioneerlabs.ru/api/gateway/v1, заголовок
"Authorization: Bearer $PIONEER_API_KEY". POST /queue/<id модели> с полями модели
возвращает request_id, status_url и response_url. Опрашивай status_url раз в
3 секунды до COMPLETED или FAILED, потом GET response_url.
Документация: https://pioneerlabs.ru/docs/media
1. Текст -> модель "flux-2/flash", тело {prompt, image_size: "landscape_4_3",
output_format: "jpeg"}. Результат images[0].url: скачай и отправь sendPhoto (multipart).
2. Фото с подписью -> модель "flux-2/edit", тело {prompt: подпись, image_urls: [data URL],
output_format: "jpeg"}. Возьми самый большой PhotoSize с width*height <= 1 000 000,
скачай через getFile и передай как base64 data: URL. Никогда не передавай модели
ссылку на файл Telegram: в ней токен бота.
3. Ответ "/animate <движение>" на картинку бота -> модель
"kling-video/v2.6/pro/image-to-video", тело {prompt, start_image_url: URL картинки,
duration: "5", generate_audio: false}. Результат video.url: скачай и отправь sendVideo.
Защита: игнорируй пользователей не из ALLOWED_USER_IDS; считай траты каждого за день
по ценам 0,69 ₽, 3,28 ₽ и 47,95 ₽ и отказывай после DAILY_CAP_RUB; ошибки (HTTP 400,
402, 422, FAILED) отправляй в чат текстом. Добавь /help и команду /spent.Как запустить сам Claude Code или Codex на моделях Пионер ИИ-шлюза, рассказано в Академии: гайд по Claude Code и гайд по Codex. Если нужен не бот, который вы поддерживаете сами, а готовый ассистент в Telegram с расписанием и навыками, посмотрите гайды по OpenClaw и Hermes Agent: оба могут вызывать тот же медиа-API из навыка.
Что это значит, если вы делаете продукт на генеративных медиа
Видео и картинки — разные продукты по цене. Разница между командами — почти 70 раз. Если вы продаёте доступ к боту, фиксированная цена за сообщение уйдёт в минус на /animate: берите плату за ролик или давайте пользователю пакет роликов.
Начинайте с дешёвой модели и улучшайте одну команду. Замените «flux-2/flash» на «flux-2» (1,64 ₽ за 1024×768), когда нужно больше деталей, или на «nano-banana-pro» для инфографики и текста на картинке, а Kling 2.6 — на Kling 3.0, когда нужны ролики от 3 до 15 секунд. Меняются только id модели и её поля, код очереди тот же.
Защиту не убирайте и при росте. Long polling справится с командой или сообществом. Для тысяч пользователей переходите на вебхук и воркер очереди, храните траты в базе и оставьте белый список или замените его платным доступом.
Попробовать в Пионер ИИ-шлюзе
FLUX 2 Flash стоит 0,69 ₽ за мегапиксель, а Kling 2.6 Pro (изображение в видео) — 9,59 ₽ за секунду без звука. На каждой странице есть плейграунд и код запроса; тот же ключ и рублёвый баланс работают для FLUX 2, Nano Banana, Seedream, Kling 3.0 и текстовых моделей, без VPN. Доступ — по заявке для компаний, частных разработчиков и авторов, кнопка «Запросить доступ» в разделе для бизнеса.
Источники
Страницы открыты 18 ноября 2026 года. Цены и параметры — со страниц моделей Пионер ИИ-шлюза и из его API, лимиты Telegram — из документации Bot API. Месячные суммы и соотношение цен — наш расчёт по этим ценам. Примеры картинок для этого поста мы не генерировали.
- Пионер ИИ-шлюз — документация API генерации изображений и видео (очередь, статус и результат, возвраты, параметры моделей)
- Пионер ИИ-шлюз — страница FLUX 2 Flash (0,69 ₽ за начатый мегапиксель, параметры)
- Пионер ИИ-шлюз — страница FLUX 2 Edit (1,64 ₽ за начатый мегапиксель результата и каждой входной картинки)
- Пионер ИИ-шлюз — страница Kling 2.6 Pro, изображение в видео (9,59 ₽ в секунду без звука, 19,18 ₽ со звуком, 5 или 10 секунд)
- Telegram — документация Bot API (long polling в getUpdates, getFile и лимит 20 МБ, лимиты sendPhoto и sendVideo, подписи до 1024 символов, sendChatAction)
Pioneer Labs продаёт доступ по API к моделям для изображений, видео и текста, включая FLUX 2 Flash, FLUX 2 Edit и Kling 2.6 Pro. Pioneer Labs не связана с Black Forest Labs, Kuaishou и Telegram.
Пионер ИИ-шлюз · один API для всех моделей
Claude, GPT, Gemini, FLUX и Kling — один ключ и один рублёвый баланс.
Без VPN и иностранной карты: компании и частные разработчики работают в чате, плейграунде и через OpenAI-совместимый API. Доступ по заявке.