lipnardo

Производственный скилл для Claude Code, предназначенный для генерации видео с говорящими AI-аватарами на базе HeyGen REST API.

Закрывает пробелы в 11 официальных скиллах HeyGen: пакетная генерация, подстановка переменных в шаблоны, пайплайн фото-в-аватар, оценка стоимости, управление вебхуками и отказоустойчивая оркестрация.

Быстрый старт (2 минуты)

Шаг 1: Получите API-ключ HeyGen

Зарегистрируйтесь на app.heygen.com, затем перейдите в Settings → API и создайте ключ. Оплата по факту использования начинается с минимального баланса $5.

Шаг 2: Скачайте и установите

bash

git clone https://github.com/AgriciDaniel/lipnardo.git
cd lipnardo
bash install.sh

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -File .\install.ps1

Установщик:

Проверяет наличие Python 3.8+
Создаёт симлинк скилла в ~/.claude/skills/lipnardo/
Создаёт директорию ~/Documents/lipnardo_videos/ для сохранения результатов
Опционально записывает API-ключ в ~/.heygen/config.json (chmod 600)

Шаг 3: Создавайте видео

Откройте Claude Code и напишите:

«Сгенерируй 30-секундное аватар-видео со словами: Welcome to Acme Industries»

Или используйте команду напрямую:

/lipnardo generate --prompt "A professional explaining quarterly results" --aspect-ratio 16:9

Возможности

Запрос...	Что происходит
«Сгенерируй аватар-видео со словами X»	AI Video Agent создаёт его (endpoint v3)
«Сделай многосценовое видео по этому сценарию»	Режим Studio (до 50 сцен)
«Сгенерируй 100 персонализированных видео из этого CSV»	Пакетный режим с очередью на 3 потока
«Переведи это видео на испанский с синхронизацией губ»	Перевод v3, режим speed или precision
«Превратить это фото в говорящий аватар»	Полный пайплайн Photo Avatar IV
«Преобразуй этот текст в речь»	TTS-движок Starfish
«Сколько это будет стоить?»	Предварительная оценка стоимости
«Скачай видео XYZ до истечения URL»	Локальная загрузка с повторными попытками

Возможности

12 производственных скриптов, ~3 500 строк, только stdlib (никаких pip install)
3 режима генерации: Video Agent (v3), Studio (v2), Template
Пакетная оркестрация с ограничением параллелизма, повторными попытками, экспоненциальной задержкой и отказоустойчивыми манифестами
Журнал расходов в ~/.heygen/costs.json (chmod 600, атомарная запись)
Перевод в режиме speed или precision (endpoint v3)
Пайплайн Photo Avatar IV: загрузка → группа → обучение → генерация
Управление вебхуками для асинхронной генерации
Защита безопасности: защита от SSRF, финансовые лимиты для пакетов, санитизация идентификаторов

Требования

Claude Code — Получить здесь (CLI, Desktop или расширение VS Code)
Python 3.8+ — только stdlib, дополнительные пакеты не требуются
API-ключ HeyGen — бесплатная регистрация, минимальный баланс $5 для первой платной генерации
Интернет — видео генерируются на серверах HeyGen, затем скачиваются локально

Тарификация

Цены устанавливаются HeyGen и списываются с вашего API-баланса. Lipnardo не добавляет комиссий.

Функция	Стоимость / сек	За минуту
Avatar III video	$0.0167	~$1.00
Video Agent (v3)	$0.0333	~$2.00
Photo Avatar (IV)	$0.0500	~$3.00
Digital Twin (IV)	$0.0667	~$4.00
Translation (speed)	$0.0333	~$2.00
Translation (precision)	$0.0667	~$4.00
Starfish TTS	$0.000667	~$0.04

Используйте /lipnardo credits estimate перед любой генерацией. Используйте --test true для бесплатных итераций с водяным знаком в процессе разработки.

Справочник команд

/lipnardo generate <prompt>      Генерация через Video Agent (v3)
/lipnardo studio <config.json>   Многосценовый Studio (v2)
/lipnardo batch <file.csv>       Пакетная генерация из CSV/JSON
/lipnardo template list          Список шаблонов HeyGen
/lipnardo template inspect <id>  Показать переменные шаблона
/lipnardo template generate <id> Генерация по шаблону
/lipnardo translate <id> <lang>  Перевод с синхронизацией губ
/lipnardo tts <text>             Starfish TTS
/lipnardo avatar create <photo>  Пайплайн Photo Avatar IV
/lipnardo avatar list            Список доступных аватаров
/lipnardo avatar voices          Список TTS-голосов
/lipnardo assets upload <file>   Загрузка в HeyGen
/lipnardo assets list            Список загруженных ресурсов
/lipnardo credits                Проверка баланса API
/lipnardo credits estimate       Предварительная оценка стоимости
/lipnardo download <id>          Скачать видео до истечения URL
/lipnardo webhook register <url> Зарегистрировать вебхук-endpoint
/lipnardo setup                  Проверка API-ключа и конфигурации

Ограничения API

3 одновременных видео максимум на стандартных планах (скрипт пакетной обработки соблюдает это ограничение)
30 минут максимальная длительность видео (для большего требуется Enterprise)
1080p разрешение по умолчанию (4K только для Enterprise)
Photo Avatar IV: жёсткий лимит 3 минуты
URL для скачивания: истекают через 7 дней — скачивайте своевременно
50 сцен максимум на один запрос к Studio API

Для устойчивой генерации 500+ видео в месяц обратитесь в отдел продаж HeyGen для получения Enterprise API-тарифов (обычно скидка 30–50% от прайса + повышенные лимиты параллелизма).

Архитектура

lipnardo/
├── README.md, LICENSE, SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md
├── install.sh, install.ps1, uninstall.sh
├── .gitignore
└── skills/lipnardo/
    ├── SKILL.md                    # Манифест скилла (стандарт Agent Skills)
    └── scripts/
        ├── heygen_client.py        # Импортируемый модуль: авторизация, HTTP, поллинг, загрузка, валидация
        ├── generate_video.py       # Video Agent (v3) + Studio (v2)
        ├── batch_generate.py       # Менеджер очереди с повторными попытками и восстановлением после сбоев
        ├── template_video.py       # Список/просмотр/генерация шаблонов
        ├── translate_video.py      # Перевод v3 (speed | precision)
        ├── tts.py                  # Starfish TTS
        ├── photo_avatar.py         # Пайплайн Avatar IV
        ├── asset_manager.py        # Загрузка/список ресурсов
        ├── credit_check.py         # Проверка баланса и оценка стоимости
        ├── download_video.py       # Загрузка с повторными попытками
        └── webhook_manager.py      # Управление вебхуками

lipnardo

Установка

README

lipnardo

Быстрый старт (2 минуты)

Шаг 1: Получите API-ключ HeyGen

Шаг 2: Скачайте и установите

Шаг 3: Создавайте видео

Возможности

Возможности

Требования

Тарификация

Справочник команд

Ограничения API

Архитектура

Похожие скиллы

claude-mem

oh-my-openagent

Агенты и оркестрация

NanoClaw