Gere vídeos do seu avatar no HeyGen a partir de um texto — 9:16, 720p, voz em português — e receba o MP4 direto no bot do openpcbot. Um comando, dois caminhos de crédito.
node heygen.mjs --text "O trem da IA já saiu da estação..." ✓ key OK · créditos de API: 249 ✓ render iniciado · video_id 9d58…190c ...0s status=processing ✓ baixado: trem-da-ia.mp4 4.95 MB ✓ custo: 51 créditos de API · restam 198 ✓ telegram: enviado ao bot (msg 2782)
VideosAvatar é o pacote INEMA que transforma um roteiro de texto num vídeo do seu avatar no HeyGen e entrega pronto no Telegram. Toda a chatice (chamar a API, esperar o render, baixar, medir o custo, mandar no bot) já vem resolvida em duas skills do Claude Code.
Usa o photo avatar do Nei (engine Avatar IV) com a voz clonada, forçada para português. Dá pra trocar por qualquer um dos avatares e das 46 vozes PT da conta.
Você manda a fala; ele cria o vídeo, espera o render, baixa o MP4 em ~/projetos/output/heygen/ e entrega no bot do openpcbot com legenda do custo.
Escolha entre o wallet de API (pay-as-you-go) ou os créditos da assinatura (via MCP). Mesma geração, billing diferente — você decide qual queimar primeiro.
Do texto ao bot, sempre o mesmo caminho — muda só de onde sai o crédito.
Avatares prontos: +1.100 públicos, é só escolher o ID.
Instant / Digital Twin (Avatar V): clona seu rosto e voz a partir de um selfie de ~15s. Melhor para vídeo.
Photo Avatar (Avatar IV): vira apresentador falante a partir de 1 foto. É o avatar do Nei.
Criar o avatar é feito no app do HeyGen; depois a automação só usa o avatar_id.
API key → skill heygen-cli. Chama POST /v3/videos, gasta o pool de API (pay-as-you-go).
MCP remoto → skill heygen-mcp. Conector OAuth, gasta os créditos da assinatura.
Os dois entregam no mesmo bot e usam os mesmos IDs de avatar/voz. Detalhe de billing na seção Créditos.
Tudo é lido do .env do openpcbot. Nenhuma credencial fica na página nem no repo.
Um dos dois cofres: wallet de API (pay-as-you-go, a partir de US$5) ou assinatura com créditos de plano.
No .env do openpcbot:
# HeyGen HEYGEN_API_KEY=… HEYGEN_AVATAR_ID_NEI=… HEYGEN_VOICE_ID_NEI=… # entrega no bot TELEGRAM_BOT_TOKEN=… ALLOWED_CHAT_ID=…
Node 18+ (para o CLI). Para o caminho da assinatura, o conector MCP do HeyGen conectado via OAuth.
No Claude Code, é só pedir em linguagem natural ("faz um vídeo do meu avatar falando X") — as skills disparam sozinhas. Por baixo, isto é o que roda.
O caminho padrão. Só a fala é obrigatória; o resto tem default (9:16, 720p, voz PT-BR, entrega no bot).
node ~/.claude/skills/heygen-cli/scripts/heygen.mjs --text "sua fala aqui"
Flags opcionais para mudar enquadramento, resolução, voz ou perfil — ou só salvar local sem mandar no bot.
node heygen.mjs --text-file roteiro.txt \ --ratio 16:9 --res 1080p --voice <voice_id> --no-send
Lista as vozes PT (46 na conta) e os perfis/avatares disponíveis.
node heygen.mjs voices --lang pt # vozes em português node heygen.mjs avatars # seus avatares/perfis node heygen.mjs --text "oi" --dry-run # valida sem gastar (custo 0)
Para usar os créditos do plano em vez do wallet de API: conecte o MCP remoto do HeyGen (OAuth, sem API key) e autentique uma vez.
claude mcp add --transport http heygen https://mcp.heygen.com/mcp/v1/ # depois: /mcp → heygen → Authenticate (login no navegador)
Quando o MCP devolve a URL do MP4, o helper baixa, salva e manda no bot do openpcbot com a legenda.
node ~/.claude/skills/heygen-mcp/scripts/deliver.mjs \ --url "<url_do_mp4>" --slug minha-campanha \ --caption "🎬 via assinatura · 9:16 · PT-BR"
O CLI mede o custo real lendo a quota antes/depois e imprime quantos créditos saíram. Não estime — leia o número.
✓ custo: 51 créditos de API · restam 198
O HeyGen separa o billing da API do billing do plano web. A API key nunca toca os créditos da assinatura, e vice-versa. Por isso existem duas skills.
| Caminho | Cofre que gasta | Auth | Skill | Quando usar |
|---|---|---|---|---|
| API direta (v3) | pool de API (pay-as-you-go) | API key | heygen-cli | fallback / quando o plano zerou |
| MCP remoto | créditos da assinatura (plano) | OAuth | heygen-mcp | preferido — créditos já pagos no mês |
Queime a assinatura primeiro (já está paga) e deixe o wallet de API como reserva.
O avatar do Nei é photo avatar (Avatar IV). Por isso o default é 720p e vídeos curtos, mantendo o gasto baixo.
A voz clonada está cadastrada como inglês — a automação força locale pt-BR. Confira de ouvido o 1º render.
Um vídeo provocativo de ~14s, 9:16, voz PT-BR, gerado e entregue no bot num único comando.
"O trem da IA já saiu da estação. Quem embarca agora sai na frente. Quem espera, perde — como perdeu a internet e as redes sociais. A diferença não é idade, é atitude. Embarque agora: inema.club"
Formato: 9:16 · 720p · ~14s · voz PT-BR
Render: ~75s · MP4 de 4.95 MB
Custo: 51 créditos de API (medido na quota)
Entrega: automática no bot do openpcbot
O núcleo (gerar + entregar + medir custo) já roda. As próximas fases são conforto e integração com o resto do ecossistema INEMA.
heygen-cli (API), skill heygen-mcp (assinatura), entrega no bot do openpcbot, custo medido pela quota, esta página de guia.