guides

HeyGen Avatar 6 API : qu’est-ce que HeyGen Avatar 6, identifiants de modèle, modes d’entrée, limites et prix

Poyo.ai Team
10 min read
Share:

HeyGen Avatar 6 API sur PoYo : identifiants de modèle, modes d’entrée, limites et prix

La HeyGen Avatar 6 API est disponible sur PoYo avec deux identifiants de modèle : heygen-avatar-6 et le niveau Turbo heygen-avatar-6-turbo, à la moitié du prix en 1080p. Les deux transforment une photo, une vidéo de référence d’un personnage animé ou l’un des 1,248 looks d’avatars publics de HeyGen en un MP4 parlant avec synchronisation labiale, en 1080p ou en 2K, piloté par votre audio ou, pour les avatars publics, par du texte. Vous pouvez essayer les deux niveaux sur la page du modèle HeyGen Avatar 6 avant d’écrire la moindre ligne de code.

Cette présentation couvre ce que HeyGen a lancé, le format de requête sur PoYo, les limites que votre code doit valider, le prix à la seconde et ce que nous avons mesuré le jour du lancement.

Qu’est-ce que HeyGen Avatar 6 ?

HeyGen Avatar 6 est le modèle vidéo d’avatar parlant de HeyGen. Le rapport technique de HeyGen, daté du 17 novembre 2026, affirme qu’« Avatar 6 reproduit l’apparence, la façon de parler et les mouvements d’une personne, jusqu’en 2K » et qu’il fonctionne « à partir d’une seule photo ». HeyGen décrit deux niveaux, Avatar 6 Quality et Avatar 6 Turbo ; sur PoYo, ils correspondent à heygen-avatar-6 et heygen-avatar-6-turbo.

DateÉvénement
17 novembre 2026HeyGen publie le rapport technique d’Avatar 6
19 novembre 2026Les deux niveaux sont appelables sur PoYo sous heygen-avatar-6 et heygen-avatar-6-turbo

Trois affirmations de HeyGen comptent pour une intégration, car elles correspondent à des champs de requête :

  • 2K natif. HeyGen indique que « chaque image [est] générée en 2880×1620 ». Sur PoYo, vous le choisissez avec "resolution": "2K".
  • Prompts de mouvement. Le rapport de HeyGen dit : « Écrivez l’action à côté des mots. Avatar 6 l’exécute pile au bon moment. » Sur PoYo, c’est le champ prompt, jusqu’à 1,200 caractères.
  • Préféré à Avatar V. Lors du vote en ligne de HeyGen, 69.7% des 879 votes ont préféré Avatar 6 Quality à Avatar V, et 64.3% des 863 votes ont préféré Avatar 6 Turbo à Avatar V Turbo. Ce sont les chiffres de HeyGen.

La HeyGen Avatar 6 API en bref

Élémentheygen-avatar-6heygen-avatar-6-turbo
Niveau HeyGenAvatar 6 QualityAvatar 6 Turbo
Endpoint de soumissionPOST https://api.poyo.ai/api/generate/submitIdentique
RésultatGET /api/generate/status/{task_id} ou callback_urlIdentique
Modes d’entréePhoto, vidéo de référence, avatar publicLes trois mêmes
SortieUn MP4, 1080p (par défaut) ou 2KIdentique
Entrée vocaleAudio de 2–60 s, ou texte jusqu’à 1,000 caractères (avatar public uniquement)Identique
Prix, 1080p20 crédits ($0.10) par seconde10 crédits ($0.05) par seconde
Prix, 2K29 crédits ($0.145) par seconde18 crédits ($0.09) par seconde

Les champs de requête sont identiques : changer de niveau revient donc à modifier uniquement la chaîne model. Les règles des champs figurent dans la documentation PoYo de HeyGen Avatar 6.

Trois modes d’entrée, un seul endpoint

Il n’existe pas de champ mode. Ce sont les entrées envoyées qui déterminent le mode, dans cet ordre :

ModeSélectionné quandEntréesFormat d’image
Avatar publicavatar est présentavatar + text (+ voice facultatif), ou avatar + audio_urlaspect_ratio : 16:9 (par défaut), 9:16, 1:1, 4:5, 5:4
Vidéo de référencevideo_url est présent (et pas d’avatar)video_url + audio_url, avec une photo facultative dans image_urlsSuit la vidéo d’entrée
PhotoPar défautimage_urls (exactement une) + audio_urlSuit la photo d’entrée

prompt et resolution fonctionnent dans tous les modes. aspect_ratio et voice appartiennent uniquement au mode avatar public. Envoyez les entrées d’un seul mode par requête. La documentation développeur de HeyGen répartit ce travail entre deux API distinctes (une API de modèle pour image ou vidéo plus audio, et une API applicative pour les looks d’avatars HeyGen) ; sur PoYo, c’est une seule forme de requête pour les deux.

Le mode vidéo de référence est destiné aux personnages animés ou illustrés. Pour une personne réelle, utilisez le mode photo avec une seule photo.

Limites à valider avant de soumettre

ChampRègle
image_urlsExactement une URL ; image_urls[0] est utilisée
video_urlAu moins 2 secondes, jusqu’à 50 MB
audio_url2–60 secondes, jusqu’à 15 MB ; la vidéo dure aussi longtemps que l’audio
text1–1,000 caractères (mode avatar public, à la place de audio_url)
avatarL’un des 1,248 noms (156 personnes) ; la casse et les espaces superflus sont ignorés
voiceL’un des 102 noms ; par défaut Warm Pro Narrator
promptJusqu’à 1,200 caractères
resolution1080p ou 2K

Toutes les URL de médias doivent être publiques et directement téléchargeables en HTTP ou HTTPS. PoYo vérifie la durée de l’audio, la durée de la vidéo de référence et le nom de l’avatar dès la soumission : les entrées invalides échouent donc immédiatement plutôt qu’après une attente. La sortie peut être environ un dixième de seconde plus courte que l’audio. Tous les noms d’avatars et de voix figurent dans Avatars and Voices, avec un catalogue JSON téléchargeable.

Prix de la HeyGen Avatar 6 API sur PoYo

PoYo facture à la seconde de sortie, en crédits (1 crédit = $0.005) :

Modèle1080p par seconde2K par seconde10 s en 1080p60 s en 1080p
heygen-avatar-6-turbo10 crédits ($0.05)18 crédits ($0.09)100 crédits ($0.50)600 crédits ($3.00)
heygen-avatar-620 crédits ($0.10)29 crédits ($0.145)200 crédits ($1.00)1,200 crédits ($6.00)

Les secondes facturées sont arrondies à la seconde entière supérieure. Avec audio_url, le montant suit la durée de l’audio et est prélevé à la soumission. Avec text, PoYo réserve des crédits à la soumission et ajuste le montant à la durée de la vidéo finale à la fin de la tâche. Le détail complet, avec des exemples chiffrés, se trouve dans Prix de la HeyGen Avatar 6 API.

Résultats des tests le jour du lancement

L’équipe PoYo a effectué ces tests sur l’API de production le 19 novembre 2026, en mode avatar public avec du texte. Le temps écoulé est mesuré de la soumission au résultat, tel que vu par un client qui interroge l’API ; considérez-le comme approximatif.

ModèleAvatar / voixScriptSortieCoût aux prix actuelsTemps écoulé
heygen-avatar-6-turboAbigail Office Front / Jessica Anne Bogart27 mots, 16:9, 1080p10.16 s110 crédits (11 s × 10)Environ 2.4 min
heygen-avatar-6Bryan Tech Expert / Andrew21 mots, 16:9, 1080p6.88 s140 crédits (7 s × 20)Environ 2 min

Deux minutes ou plus pour un court extrait signifient qu’il s’agit d’une API asynchrone : soumettez, conservez le task_id, puis interrogez le statut ou recevez un callback. Ne gardez pas une requête HTTP côté utilisateur ouverte pendant l’exécution.

Démarrage rapide avec la HeyGen Avatar 6 API

Voici l’exemple de la documentation pour le mode avatar public avec du texte :

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "heygen-avatar-6-turbo",
    "input": {
      "avatar": "Abigail Office Front",
      "text": "Hello and welcome to this demonstration of HeyGen Avatar 6.",
      "voice": "Warm Pro Narrator",
      "prompt": "Speak with calm confidence and nod slightly at the end.",
      "aspect_ratio": "16:9",
      "resolution": "1080p"
    }
  }'

Vérifiez code dans le corps de la réponse (il doit valoir 200), enregistrez data.task_id, puis appelez GET https://api.poyo.ai/api/generate/status/{task_id} jusqu’à ce que status soit finished, et lisez le MP4 dans data.files[].file_url. Les vidéos générées restent disponibles 3 jours ; copiez-les donc dans votre propre stockage. Le mode photo, le mode vidéo de référence, une boucle Python bornée et la gestion des erreurs sont présentés dans le guide de la HeyGen Avatar 6 API.

Quelles requêtes envoyer à la HeyGen Avatar 6 API

BesoinAppel
Une vidéo de présentateur à partir d’un script, sans fichier audioheygen-avatar-6 ou -turbo en mode avatar public (tutoriel texte vers avatar)
La photo d’une personne réelle qui prononce votre audio, en 1080p ou 2KMode photo
Une mascotte ou un personnage de dessin animé qui parleMode vidéo de référence
Brouillons, aperçus, gros volumesheygen-avatar-6-turbo (voir Avatar 6 vs Turbo)
Le prix à la seconde le plus bas à partir d’une photo et d’un audioComparez avec Kling Avatar 2.0
Un audio de plus de 60 secondesOmniHuman 2.0 accepte 4–300 s d’audio en 720p, à 21 crédits par seconde

Questions fréquentes

Quels sont les identifiants de modèle de la HeyGen Avatar 6 API ?

heygen-avatar-6 (le niveau Avatar 6 Quality de HeyGen) et heygen-avatar-6-turbo. Les deux utilisent POST https://api.poyo.ai/api/generate/submit avec les mêmes champs input.

Combien coûte la HeyGen Avatar 6 API ?

Sur PoYo, par seconde de sortie : Turbo 10 crédits ($0.05) en 1080p et 18 crédits ($0.09) en 2K ; Avatar 6 20 crédits ($0.10) en 1080p et 29 crédits ($0.145) en 2K. Les secondes sont arrondies à l’entier supérieur.

La HeyGen Avatar 6 API peut-elle créer une vidéo à partir de texte seul ?

Oui, en mode avatar public. Envoyez avatar et jusqu’à 1,000 caractères de text, plus une voice facultative parmi les 102 voix répertoriées. Les modes photo et vidéo de référence nécessitent audio_url.

Quelle durée peut avoir une vidéo de la HeyGen Avatar 6 API ?

Avec un audio, 2–60 secondes, comme l’audio. Avec du texte, la vidéo dure le temps que met l’avatar à lire jusqu’à 1,000 caractères.

Quelles résolutions la HeyGen Avatar 6 API prend-elle en charge ?

1080p (par défaut) et 2K. Le mode avatar public ajoute aspect_ratio (16:9, 9:16, 1:1, 4:5, 5:4) ; les autres modes conservent le format de l’entrée.

La HeyGen Avatar 6 API prend-elle en charge les webhooks ?

Oui. Ajoutez un callback_url au premier niveau et PoYo envoie le résultat de la tâche lorsqu’elle est finished ou failed. Vous pouvez aussi interroger l’endpoint de statut.

Share: