Una API key
Usa las mismas credenciales entre modelos y proveedores.
Accede a la API de HeyGen Video a través de RunAPI con una habilidad de modelo, autenticación unificada y precios de pago por uso.
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": "Genera un video de producto de 10 segundos en 1080p de una taza de cerámica sobre una encimera de cocina soleada, usando la imagen de referencia para mantener el diseño de la taza y añadiendo un suave sonido ambiente."
}'
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: "Genera un video de producto de 10 segundos en 1080p de una taza de cerámica sobre una encimera de cocina soleada, usando la imagen de referencia para mantener el diseño de la taza y añadiendo un suave sonido ambiente.",
});
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: "Genera un video de producto de 10 segundos en 1080p de una taza de cerámica sobre una encimera de cocina soleada, usando la imagen de referencia para mantener el diseño de la taza y añadiendo un suave sonido ambiente."
)
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
La API de HeyGen Video (ID de modelo heygen-video-1) genera videos de 5 a 15 segundos y produce diálogos, ambiente y efectos en la misma solicitud. Crea a partir de un texto, anima una imagen de primer fotograma o guía la generación con imágenes, videos y audios de referencia para mantener coherentes productos, personas y lugares.
| ID de modelo | heygen-video-1 |
| Proveedor | HeyGen |
| Modalidad | video |
| Tipo de tarea | asynchronous |
| Facturación | segundo |
| Endpoint | /api/v1/heygen_video/image_to_video |
| Comercial | Sí |
| Estado del catálogo | Operativo |
Selecciona el modelo y la variante que encajan con tu tipo de salida, calidad objetivo y latencia.
Usa tu clave RunAPI para todos los modelos compatibles.
Añade el model skill a tu workspace de código antes de implementar la función.
Consulta por task ID o procesa el callback cuando termine la generación.
Texto a video, imagen a video y generación guiada por referencias usan el mismo ID de modelo de RunAPI. La salida va de 480p a 2K; el modo de referencia admite hasta 9 imágenes, 3 videos y 3 clips de audio, con un máximo de 12 archivos de referencia en total.
Usa las mismas credenciales entre modelos y proveedores.
El model skill incluye schemas, notas de setup, contexto de precios e IDs de modelo.
El precio por uso es visible antes de llamar.
Envía heygen-video-1 como valor de model. El endpoint de texto a video recibe un prompt y, opcionalmente, imágenes, videos o audios de referencia; el de imagen a video recibe un prompt y una imagen de primer fotograma.
Usa un texto, una imagen de primer fotograma o imágenes, videos y audios de referencia. La salida dura de 5 a 15 segundos en 480p, 768p, 1080p o 2K e incluye sonido generado.
Sí. Los diálogos, el ambiente y los efectos se generan en la misma solicitud que el video.
La facturación es por segundo de video. La tabla de precios de esta página indica la tarifa actual por resolución y tipo de entrada, y las generaciones fallidas no se cobran.
No. HeyGen Video es el modelo de video general de HeyGen y construye toda la escena, con sonido incluido, a partir de un prompt o de imágenes. Los videos de avatares parlantes creados con un guion y una voz elegida proceden de la API de avatares de HeyGen, independiente, que RunAPI no ofrece.
Instala el model skill y sigue sus notas de setup con tu clave RunAPI.