Une API key
Utilisez les mêmes identifiants pour les modèles et les fournisseurs.
Utilisez l'API HeyGen Video via RunAPI avec une compétence de modèle, une authentification unifiée et une tarification à l'usage.
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": "Génère une vidéo produit de 10 secondes en 1080p d'une tasse en céramique sur un plan de travail de cuisine ensoleillé, en utilisant l'image de référence pour garder le design de la tasse cohérent et en ajoutant une douce ambiance sonore."
}'
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: "Génère une vidéo produit de 10 secondes en 1080p d'une tasse en céramique sur un plan de travail de cuisine ensoleillé, en utilisant l'image de référence pour garder le design de la tasse cohérent et en ajoutant une douce ambiance sonore.",
});
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: "Génère une vidéo produit de 10 secondes en 1080p d'une tasse en céramique sur un plan de travail de cuisine ensoleillé, en utilisant l'image de référence pour garder le design de la tasse cohérent et en ajoutant une douce ambiance sonore."
)
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
L'API HeyGen Video (ID de modèle heygen-video-1) génère des vidéos de 5 à 15 secondes, avec dialogues, ambiances et effets sonores produits dans la même requête. Créez à partir d'un texte, animez une image de départ ou guidez la génération avec des images, vidéos et audios de référence pour garder produits, personnes et lieux cohérents.
| ID de modèle | heygen-video-1 |
| Fournisseur | HeyGen |
| Modalité | video |
| Type de tâche | asynchronous |
| Facturation | seconde |
| Endpoint | /api/v1/heygen_video/image_to_video |
| Commercial | Oui |
| Statut du catalogue | Opérationnel |
Sélectionnez le modèle et la variante adaptés au type de sortie, au niveau de qualité et à la latence cible.
Utilisez votre clé RunAPI pour tous les modèles pris en charge.
Ajoutez le model skill à votre workspace de code avant d'implémenter la fonctionnalité.
Interrogez par task ID ou traitez le callback quand la génération se termine.
Texte-vers-vidéo, image-vers-vidéo et génération guidée par références utilisent le même identifiant de modèle RunAPI. La sortie va de 480p à 2K ; le mode référence accepte jusqu'à 9 images, 3 vidéos et 3 clips audio, avec au plus 12 fichiers de référence au total.
Utilisez les mêmes identifiants pour les modèles et les fournisseurs.
Le model skill inclut schémas, notes de setup, contexte tarifaire et IDs de modèle.
Les tarifs à l'usage sont visibles avant l'appel.
Envoyez heygen-video-1 comme valeur de model. L'endpoint texte vers vidéo accepte un prompt et, en option, des images, vidéos ou audios de référence ; l'endpoint image vers vidéo accepte un prompt et une image de départ.
Utilisez un texte, une image de départ, ou des images, vidéos et audios de référence. La sortie dure de 5 à 15 secondes en 480p, 768p, 1080p ou 2K et inclut du son généré.
Oui. Dialogues, ambiances et effets sont générés dans la même requête que la vidéo.
La facturation se fait à la seconde de vidéo. Le tableau des tarifs de cette page indique le tarif actuel pour chaque résolution et type d'entrée, et les générations échouées ne sont pas facturées.
Non. HeyGen Video est le modèle vidéo généraliste de HeyGen : il construit toute la scène, son compris, à partir d'un prompt ou d'images. Les vidéos d'avatars parlants créées à partir d'un script et d'une voix choisie relèvent de l'API d'avatars de HeyGen, distincte, que RunAPI ne propose pas.
Installez le model skill et suivez ses notes de setup avec votre clé RunAPI.