HeyGen · Vídeo

OpenClaw x HeyGen Video

Texto para vídeo, imagem para vídeo e geração guiada por referências usam o mesmo ID de modelo da RunAPI. A saída vai de 480p a 2K; o modo de referência aceita até 9 imagens, 3 vídeos e 3 clipes de áudio, com no máximo 12 arquivos de referência no total.

1 variants a partir de $0.09 / segundo Uso comercial permitido

Prerequisite: npx runapi mcp install

Prompt

Modelos de prompt

Use heygen-video-1 quando ele corresponder à tarefa: heygen-video-1.

You have access to RunAPI task tools for HeyGen Video.

Available HeyGen Video models:
- heygen-video-1: heygen-video-1
  endpoints: /api/v1/heygen_video/text_to_video, /api/v1/heygen_video/image_to_video
  request fields: model, prompt, output_resolution, aspect_ratio

Use the model ID and endpoint that match the user's request.
Example prompt: Gere um vídeo de produto de 10 segundos em 1080p de uma caneca de cerâmica em uma bancada de cozinha ensolarada, usando a imagem de referência para manter o design da caneca e adicionando um som ambiente suave.
/api/v1/heygen_video/text_to_video: Submit the task, poll for its status, then verify the completed output. Envie POST para /api/v1/heygen_video/text_to_video e salve o ID da Task retornada.
Envie GET para /api/v1/heygen_video/text_to_video/<task-id> até o status ser completed ou failed.
Verifique se a resposta completed contém a saída específica do endpoint documentada na referência da API.
/api/v1/heygen_video/image_to_video: Submit the task, poll for its status, then verify the completed output. Envie POST para /api/v1/heygen_video/image_to_video e salve o ID da Task retornada.
Envie GET para /api/v1/heygen_video/image_to_video/<task-id> até o status ser completed ou failed.
Verifique se a resposta completed contém a saída específica do endpoint documentada na referência da API.

Versões e endpoints públicos

ID do modelo Endpoints Preço inicial Catálogo
heygen-video-1
/api/v1/heygen_video/text_to_video /api/v1/heygen_video/image_to_video
$0.09 / segundo Detalhes do modelo

Verificar

Consulte até que a Task alcance um estado final

Envie POST para /api/v1/heygen_video/text_to_video e salve o ID da Task retornada.
Envie GET para /api/v1/heygen_video/text_to_video/<task-id> até o status ser completed ou failed.
Verifique se a resposta completed contém a saída específica do endpoint documentada na referência da API.

Configuração

Endpoint do guia: /api/v1/heygen_video/text_to_video

export RUNAPI_API_KEY=your_api_key

curl -X POST https://runapi.ai/api/v1/heygen_video/text_to_video \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "heygen-video-1",
  "prompt": "A plant supervisor in a plain grey coat stands beside a conveyor line and speaks to camera.",
  "output_resolution": "768p",
  "aspect_ratio": "16:9"
}'
Como funciona

Comece em 3 passos

  1. Escolha um ID de modelo

    Selecione um ID público do catálogo e confira seu endpoint e preço inicial atual.

  2. Configure o RunAPI

    Defina RUNAPI_API_KEY antes de enviar a solicitação ao endpoint.

  3. Verifique o resultado

    Para endpoints assíncronos, consulte o mesmo endpoint até que a Task alcance um estado final.

O que criar com OpenClaw + HeyGen Video

  • Clipes de produto e marketing

    Crie clipes promocionais curtos para páginas de produto, anúncios e landing pages a partir de um briefing escrito.

  • Vídeos curtos para redes sociais

    Produza clipes curtos para redes sociais e teste várias versões da mesma ideia antes de escolher uma.

  • Animação de imagens e edição de vídeo

    Anime imagens estáticas ou altere vídeos existentes quando o modelo oferece endpoints de imagem para vídeo ou de edição de vídeo.

Por que usar HeyGen Video pelo RunAPI + OpenClaw

  • 1 variantes, uma chave de API

    Use uma única conexão do RunAPI para escolher entre as variantes de modelo disponíveis sem mudar sua integração.

  • Preços de uso claros

    Consulte os preços atuais do catálogo antes de enviar uma solicitação, sem assinatura ou gasto mínimo.

  • Fluxos de tarefas automáticos

    Envie tarefas, consulte seu status e reúna resultados assíncronos em um fluxo uniforme, sem escrever código de consulta manual.

Perguntas sobre OpenClaw + HeyGen Video

Qual é o ID do modelo da API HeyGen Video?

Envie heygen-video-1 como valor de model. O endpoint de texto para vídeo recebe um prompt e, opcionalmente, imagens, vídeos ou áudios de referência; o de imagem para vídeo recebe um prompt e uma imagem de primeiro quadro.

Quais entradas o HeyGen Video aceita?

Use um texto, uma imagem de primeiro quadro ou imagens, vídeos e áudios de referência. A saída dura de 5 a 15 segundos em 480p, 768p, 1080p ou 2K e inclui som gerado.

O HeyGen Video gera som?

Sim. Diálogos, ambiência e efeitos são gerados na mesma requisição do vídeo.

Como o HeyGen Video é cobrado na RunAPI?

A cobrança é por segundo de vídeo. A tabela de preços desta página mostra a tarifa atual para cada resolução e tipo de entrada, e gerações com falha não são cobradas.

Esta é a API de avatares da HeyGen?

Não. O HeyGen Video é o modelo de vídeo geral da HeyGen e constrói a cena inteira, com som incluído, a partir de um prompt ou de imagens. Vídeos de avatares falantes criados a partir de um roteiro e de uma voz escolhida vêm da API de avatares da HeyGen, separada, que a RunAPI não oferece.

Qual ID de modelo devo usar?

Escolha um ID público na tabela de versões. Cada ID expõe os endpoints mostrados em sua linha.

Este guia configura um modelo de chat?

Não. Esta linha de modelos usa o fluxo de endpoint mostrado aqui e não é apresentada como modelo de chat do agente.

Comece a usar HeyGen Video com OpenClaw

Construindo com uma equipe?

Ajudamos com a configuração empresarial, integrações e dúvidas técnicas.

Fale conosco