Uma API key
Use as mesmas credenciais entre modelos e provedores.
Use a API do HeyGen Video via RunAPI com um model skill, autenticação unificada e preços pay-as-you-go.
curl -X POST https://runapi.ai/api/v1/heygen_video/image_to_video \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "heygen-video-1",
"first_frame_image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
"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."
}'
import { HeygenVideoClient } from "@runapi.ai/heygen-video";
const client = new HeygenVideoClient();
const result = await client.imageToVideo.run({
model: "heygen-video-1",
first_frame_image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
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.",
});
require "runapi/heygen_video"
client = RunApi::HeygenVideo::Client.new
result = client.image_to_video.run(
model: "heygen-video-1",
first_frame_image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
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."
)
npx skills add runapi-ai/heygen-video -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
A API HeyGen Video (ID do modelo heygen-video-1) gera vídeos de 5 a 15 segundos e produz diálogos, ambiência e efeitos na mesma requisição. Crie a partir de um texto, anime uma imagem de primeiro quadro ou guie a geração com imagens, vídeos e áudios de referência para manter produtos, pessoas e locais consistentes.
| ID do modelo | heygen-video-1 |
| Provedor | HeyGen |
| Modalidade | video |
| Tipo de tarefa | asynchronous |
| Cobrança | segundo |
| Endpoint | /api/v1/heygen_video/image_to_video |
| Comercial | Sim |
| Status do catálogo | Operacional |
Selecione o modelo e a variante que combinam com seu tipo de saída, meta de qualidade e latência.
Use sua chave RunAPI para todos os modelos compatíveis.
Adicione o model skill ao workspace de código antes de implementar a funcionalidade.
Consulte por task ID ou trate o callback quando a geração terminar.
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.
Use as mesmas credenciais entre modelos e provedores.
O model skill inclui schemas, notas de setup, contexto de preços e IDs de modelo.
O preço por uso fica visível antes da chamada.
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.
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.
Sim. Diálogos, ambiência e efeitos são gerados na mesma requisição do vídeo.
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.
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.
Instale o model skill e siga as notas de setup com sua chave RunAPI.