HeyGen
Integração com a HeyGen.
A HeyGen gera vídeos com avatares de IA que falam o texto que você escrever, em várias vozes e idiomas — inclusive a partir de uma foto sua, transformada em "foto falante". Este MiniApp monta e dispara essa geração de dentro do fluxo, o que permite entregar um vídeo personalizado por contato, com o nome e os dados dele na fala.
Site oficial: heygen.com.
Nota
A API da HeyGen é exclusiva de contas pagas. Assine um plano de negócios ou ative um token de teste na página da sua conta, em app.heygen.com/settings?nav=API.
Ao instalar o app no canal, preencha os campos abaixo. Eles valem para todas as ações.
Campo
Obrigatório
Observação
API Key
Sim
Em app.heygen.com/settings, aba API. Disponível apenas para clientes pagantes.
Cada ação é um bloco que você usa dentro do fluxo. As entradas listadas são as obrigatórias; as saídas viram variáveis para as etapas seguintes.
Ação
O que faz
Entradas obrigatórias
Saídas
Criar Vídeo Avatar
Gera um vídeo com um avatar da HeyGen falando o texto (ou reproduzindo um áudio pronto).
Avatar, Estilo, Voz, Tipo de Áudio, Texto ou URL do Áudio, Fundo do vídeo, Proporção do vídeo
ID do Vídeo
Criar Vídeo Foto Falante
Mesma geração, usando uma foto sua transformada em avatar falante.
Foto, Estilo, Voz, Tipo de Áudio, Texto ou URL do Áudio, Fundo do vídeo, Proporção do vídeo
ID do Vídeo
Adicionar Cena Avatar
Acrescenta uma cena com avatar ao JSON de cenas, para montar um vídeo de várias partes.
Cenas (JSON), Avatar, Estilo, Voz, Tipo de Áudio, Texto ou URL do Áudio
Cenas (JSON)
Adicionar Cena Foto Falante
Acrescenta uma cena com foto falante ao JSON de cenas.
Cenas (JSON), Foto, Estilo, Voz, Tipo de Áudio, Texto ou URL do Áudio
Cenas (JSON)
Criar Vídeo com Cenas
Gera o vídeo final a partir do JSON de cenas montado nas ações acima.
Cenas, Fundo do vídeo, Proporção do vídeo
ID do Vídeo
Obter Vídeo
Consulta um vídeo pelo ID: se já ficou pronto, a URL para baixar ou enviar.
ID do Vídeo
Duração em segundos, status, thumbnail_url, video_url, Erro (JSON) se houver
Criar Webhook
Registra na HeyGen a URL que deve ser avisada quando um vídeo terminar.
URL
—
Recebeu Webhook
Processa o conteúdo que a HeyGen enviou ao webhook.
Body da Requisição
—
- A geração não é instantânea: a ação de criar devolve só o ID do Vídeo. Para saber quando ficou pronto, use o gatilho "Vídeo Gerado com Sucesso" — que entrega o ID e a URL — ou consulte com Obter Vídeo.
- Ligue "É Teste?" enquanto estiver ajustando: no modo de teste não há consumo de créditos, e o vídeo sai com marca d'água.
- O fundo aceita três formas: link público de imagem (jpg ou png), link de vídeo mp4 (que se repete se for mais curto que a fala) ou uma cor em hexadecimal, como
#FAFAFA. - A proporção é 16:9 para paisagem ou 9:16 para retrato — escolha 9:16 quando o destino é status ou Reels.
- Escala e posição colocam o avatar na tela: escala 1 é tela cheia e 0.5 é metade; na posição, 0 é o centro e -0.5 / 0.5 vão para os extremos.
- Para vídeo de várias falas, o caminho é acumular cenas: cada "Adicionar Cena" recebe e devolve o mesmo JSON, e no fim "Criar Vídeo com Cenas" monta tudo.
- NicoApps (MiniApps) Nativos — a lista completa de integrações prontas