Automação HeyGen
Automatize fluxos de trabalho de criação de vídeos com IA — navegue por avatares e modelos, gere vídeos personalizados a partir de modelos, acompanhe o status de processamento e recupere URLs compartilháveis — tudo orquestrado através da integração MCP do Composio.
Documentação do toolkit: composio.dev/toolkits/heygen
Configuração
- Conecte sua conta HeyGen através do servidor MCP do Composio em
https://rube.app/mcp - O agente solicitará um link de autenticação se nenhuma conexão ativa existir
- Após a conexão, todas as ferramentas
HEYGEN_*ficam disponíveis para execução
Fluxos de Trabalho Principais
1. Navegar pelos Modelos Disponíveis
Recupere modelos de avatar pré-projetados da biblioteca HeyGen para criação de vídeos.
Ferramenta: HEYGEN_V2_TEMPLATES
Nenhum parâmetro necessário — retorna IDs dos modelos, nomes, imagens de pré-visualização e opções de personalização.
Use esta ferramenta para descobrir modelos antes de gerar vídeos. Cada modelo possui um ID único necessário para a geração.
2. Inspecionar Detalhes e Variáveis do Modelo
Recupere a estrutura completa de um modelo, incluindo todas as variáveis, mapeamentos de cena e opções de personalização.
Ferramenta: HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
template_id | string | Sim | ID do modelo obtido de HEYGEN_V2_TEMPLATES ou do painel HeyGen |
Este é um pré-requisito obrigatório antes de gerar vídeos — ele informa exatamente quais variáveis devem ser preenchidas.
3. Navegar pelos Avatares Disponíveis
Liste todos os avatares realistas disponíveis para criação de vídeos, útil para mapear personagens para cenas.
Ferramenta: HEYGEN_V2_AVATARS
Nenhum parâmetro necessário — retorna identificadores de avatar, nomes e imagens de pré-visualização.
A lista pode ser paginada; chamadas adicionais podem ser necessárias para obter o conjunto completo.
4. Gerar Vídeo a partir de Modelo
Crie um vídeo personalizado preenchendo um modelo com suas variáveis e conteúdo.
Ferramenta: HEYGEN_V2_TEMPLATE_GENERATE
Forneça um título para o vídeo e todas as variáveis do modelo descobertas via HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3. Todas as variáveis obrigatórias devem ser fornecidas com nomes e tipos exatos.
5. Verificar Status de Processamento do Vídeo
Consulte o status de processamento e recupere metadados de um vídeo sendo gerado.
Ferramenta: HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
video_id | string | Sim | ID do vídeo retornado pela API de geração |
As URLs retornadas expiram após 7 dias, mas podem ser regeneradas chamando este endpoint novamente.
6. Obter URL Compartilhável do Vídeo
Gere um link público e compartilhável que permite que qualquer pessoa visualize o vídeo sem autenticação.
Ferramenta: HEYGEN_RETRIEVE_SHARABLE_VIDEO_URL
Forneça o video_id para receber uma URL pública para distribuição.
Armadilhas Conhecidas
| Armadilha | Detalhes |
|---|---|
| Todas as variáveis do modelo são obrigatórias | HEYGEN_V2_TEMPLATE_GENERATE exige todas as variáveis de HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 com nomes e tipos exatos — campos ausentes ou com nome incorreto quebram cenas ou impedem a geração |
| Sempre inspecione os modelos primeiro | Nunca pule HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 antes da geração — modelos com várias cenas têm estruturas de variáveis complexas |
| URLs de vídeo expiram | URLs de HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS expiram após 7 dias; regenerar chamando o endpoint novamente |
| Listas de avatares paginadas | HEYGEN_V2_AVATARS pode retornar resultados paginados — chamadas adicionais podem ser necessárias para obter a biblioteca completa |
| Tempo de processamento variável | A geração de vídeo é assíncrona; consulte HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS até que o status seja concluído antes de usar URLs de saída |
Referência Rápida
| Slug da Ferramenta | Finalidade |
|---|---|
HEYGEN_V2_TEMPLATES | Listar modelos de vídeo disponíveis |
HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 | Obter variáveis do modelo e estrutura de cena |
HEYGEN_V2_AVATARS | Navegar por avatares de IA disponíveis |
HEYGEN_V2_TEMPLATE_GENERATE | Gerar vídeo a partir de um modelo |
HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS | Verificar status de processamento do vídeo e obter URLs |
HEYGEN_RETRIEVE_SHARABLE_VIDEO_URL | Obter um link público compartilhável do vídeo |
Desenvolvido por Composio