Техническое задание: модуль «Поздравительная открытка»

Назначение

Платный модуль для генерации открыток в Telegram-боте. Используется как обложка для сгенерированной песни или отдельно в разделе «Актуальные поздравления». Оплачивается отдельно от генерации песни.

Интеграция

Вызывается в трёх случаях:

• 1) во время генерации песни,
• 2) при скачивании/отправке песни,
• 3) как самостоятельный раздел с выбором праздника (День рождения, 8 Марта и др.).

Сценарии использования

• При создании песни предлагается оформить открытку (кнопки «Создать» / «Пропустить»).
• При скачивании песни без открытки - предложение её добавить.
• Автономный выбор праздника с шаблонным промтом.

Генерация

Пользователь загружает фото, вводит текстовый или голосовой промт, либо использует комбинацию данных. Изображения генерируются через Leonardo AI, текст обрабатывается LLM (GPT-моделью).

Результат и оплата

• После генерации предложить кнопки: «Использовать», «Сгенерировать другую», «Отказаться».
• Первые 3 генерации - бесплатно, затем 1 генерация = 0,5 токена.
• Стоимость отображается до запуска генерации.
• Контент 18+ запрещён.

Использование открытки

Открытка прикрепляется к сообщению получателю и служит обложкой аудиофайла, отправляясь с ним одним сообщением.

Технические требования

• Формат: JPG/PNG, разрешение 1080x1080 или 1080x1350.
• Backend: Python (Telegram Bot API).
• База данных: PostgreSQL.
• Кэш/очереди: Redis.
• Асинхронная генерация с привязкой к user_id / song_id.
• Логирование всех генераций и оплат.
• n8n не используется.