![]()
La HeyGen Avatar 6 API sur PoYo dispose de deux identifiants de modèle : heygen-avatar-6, le niveau Avatar 6 Quality de HeyGen, et heygen-avatar-6-turbo. Ils partagent un endpoint, un format de requête et toutes les limites : le choix est donc une décision de routage par requête, entre coût et qualité, et non un projet d’intégration. Cette page présente ce qui est identique, ce qui diffère, ce que nous avons mesuré et une règle pour choisir. Les deux figurent sur la page du modèle HeyGen Avatar 6.
Ce qui est identique entre les deux niveaux de la HeyGen Avatar 6 API
La documentation PoYo de HeyGen Avatar 6 décrit Turbo comme le « niveau Turbo d’Avatar 6, avec les mêmes entrées et les mêmes modes ». La documentation développeur de HeyGen dit la même chose : les deux modèles « acceptent les mêmes entrées ».
| Élément | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| Endpoint | POST /api/generate/submit | Identique |
Mode photo (image_urls + audio_url) | Oui | Oui |
Mode vidéo de référence (video_url + audio_url) | Oui | Oui |
Mode avatar public (avatar + text/voice ou audio_url) | Oui | Oui |
| Avatars et voix | 1,248 looks, 102 voix | Même liste |
| Audio | 2–60 s, jusqu’à 15 MB | Identique |
| Texte | Jusqu’à 1,000 caractères | Identique |
prompt | Jusqu’à 1,200 caractères | Identique |
resolution | 1080p (par défaut), 2K | Identique |
aspect_ratio (avatar public) | 16:9, 9:16, 1:1, 4:5, 5:4 | Identique |
| Règles de facturation | Secondes arrondies à l’entier supérieur ; audio prélevé à la soumission, texte réservé puis ajusté | Identiques |
Comme rien ne change dans input, un corps de requête qui fonctionne sur un modèle fonctionne sur l’autre. Le changement se limite à la chaîne model.
Ce qui diffère : le prix
1 crédit = $0.005, par seconde de sortie :
| Résolution | heygen-avatar-6 | heygen-avatar-6-turbo | Économie avec Turbo |
|---|---|---|---|
| 1080p | 20 crédits ($0.10) | 10 crédits ($0.05) | 50% |
| 2K | 29 crédits ($0.145) | 18 crédits ($0.09) | 38% |
Prix pour un même extrait, en ne changeant que l’identifiant de modèle :
| Extrait | heygen-avatar-6 | heygen-avatar-6-turbo |
|---|---|---|
| 10 s, 1080p | 200 crédits ($1.00) | 100 crédits ($0.50) |
| 10 s, 2K | 290 crédits ($1.45) | 180 crédits ($0.90) |
| 30 s, 1080p | 600 crédits ($3.00) | 300 crédits ($1.50) |
| 60 s, 1080p | 1,200 crédits ($6.00) | 600 crédits ($3.00) |
| 60 s, 2K | 1,740 crédits ($8.70) | 1,080 crédits ($5.40) |
Une autre comparaison influe sur le routage : Turbo en 2K (18 crédits par seconde) coûte moins cher qu’Avatar 6 en 1080p (20). Si vous avez davantage besoin de la définition que du niveau Quality, Turbo 2K est le moyen le moins cher de l’obtenir.
Les détails sont dans Prix de la HeyGen Avatar 6 API.
Ce qui diffère : qualité et vitesse, selon HeyGen
HeyGen nomme les niveaux « Avatar 6 Quality » et « Avatar 6 Turbo » dans son rapport technique, mais ne définit pas la différence entre eux et ne publie aucun chiffre de latence pour Turbo. Ce qu’il publie, c’est chaque niveau face à son propre prédécesseur : 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. HeyGen n’a pas publié de vote Quality contre Turbo : il n’existe donc aucun chiffre officiel sur ce que vous sacrifiez avec Turbo.
Ce que nous avons mesuré le jour du lancement
L’équipe PoYo a exécuté une requête texte sur chaque modèle, sur l’API de production, le 19 novembre 2026. Le temps écoulé est mesuré de la soumission au résultat pour un client qui interroge le statut toutes les quelques secondes ; considérez-le comme approximatif.
heygen-avatar-6-turbo | heygen-avatar-6 | |
|---|---|---|
| Avatar / voix | Abigail Office Front / Jessica Anne Bogart | Bryan Tech Expert / Andrew |
| Script | 27 mots | 21 mots |
| Paramètres | 16:9, 1080p | 16:9, 1080p |
| Durée de sortie | 10.16 s | 6.88 s |
| Coût aux prix actuels | 110 crédits (11 s × 10) | 140 crédits (7 s × 20) |
| Temps écoulé | Environ 2.4 min | Environ 2 min |
Il s’agit de deux exécutions uniques, avec des scripts et des avatars différents : elles ne montrent donc pas si Turbo est plus rapide ou plus lent. Elles montrent en revanche l’écart de coût en pratique : l’extrait Turbo, plus long, a quand même coûté moins cher que l’extrait Avatar 6, plus court. Elles montrent aussi que les deux niveaux prennent plusieurs minutes : aucun n’est une API synchrone où l’on attend la réponse à la requête. Prévoyez dans tous les cas du polling ou un callback_url.
Quel identifiant de modèle de la HeyGen Avatar 6 API appeler
| Situation | Identifiant de modèle | Pourquoi |
|---|---|---|
| Brouillons, revues du script et du rythme | heygen-avatar-6-turbo | Moitié prix en 1080p ; mêmes champs, donc le corps approuvé se relance tel quel sur Avatar 6 |
| Extraits personnalisés à gros volume | heygen-avatar-6-turbo | Le coût à la seconde domine à grande échelle |
| Aperçus pour les utilisateurs de votre application | heygen-avatar-6-turbo | Itérations peu coûteuses pendant que l’utilisateur essaie avatars et scripts |
| Vidéo finale de présentateur ou de marque | heygen-avatar-6 | Le niveau Quality de HeyGen |
| Besoin de 2K avec un budget serré | heygen-avatar-6-turbo + 2K | 18 crédits par seconde, moins qu’Avatar 6 en 1080p |
| Master final en 2K | heygen-avatar-6 + 2K | Le meilleur niveau à la meilleure résolution |
Un pipeline en deux étapes s’impose naturellement : générez chaque brouillon sur Turbo, enregistrez le corps de requête exact, puis resoumettez le corps approuvé avec "model": "heygen-avatar-6". Les deux requêtes ci-dessous sont identiques, au modèle près :
{
"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",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
}
{
"model": "heygen-avatar-6",
"input": {
"avatar": "Abigail Office Front",
"text": "Hello and welcome to this demonstration of HeyGen Avatar 6.",
"voice": "Warm Pro Narrator",
"aspect_ratio": "16:9",
"resolution": "1080p"
}
}
Avec une entrée texte, le rendu final est une nouvelle génération : sa durée peut donc différer légèrement de celle du brouillon. Avec un fichier audio, les deux rendus durent aussi longtemps que le même audio et coûtent exactement ce que prévoit le tableau. Pour le déroulé complet d’une requête, voir le guide de la HeyGen Avatar 6 API.
Erreurs et nouvelles tentatives identiques sur les deux niveaux
Router entre les deux identifiants ne change pas la gestion des erreurs. Les deux renvoient les mêmes valeurs de code dans le corps : 400 pour un problème d’entrée (audio hors de 2–60 s, nom d’avatar inconnu, champs de deux modes), 402 insufficient_credits_error quand le solde est insuffisant, 429 pour les limites de débit et 5xx pour les échecs transitoires. Un 400 sur Turbo sera aussi un 400 sur Avatar 6 : ne « réessayez » donc jamais « sur l’autre niveau » pour corriger une erreur de validation. Corrigez plutôt l’entrée.
Les réservations s’appliquent aux deux niveaux. Les tâches texte de l’un ou l’autre modèle retiennent des crédits de la soumission jusqu’à leur règlement, et le message 402 les additionne toutes. Lors de notre test du jour du lancement, après la soumission d’une tâche texte Turbo et d’une tâche texte Avatar 6, une troisième requête texte (Turbo, 2K) a été refusée avec HTTP 200 et un code 402 dans le corps : « this request needs at least 252 credits, and 344 credits are already reserved by your unfinished HeyGen Avatar 6 text tasks. » Prévoyez un solde suffisant pour toutes les tâches texte en cours, quel que soit le modèle sur lequel elles tournent.
Une fonction de routage
import math
def pick_model(final: bool) -> str:
"""Route a HeyGen Avatar 6 request. Fields stay identical; only the model changes."""
return "heygen-avatar-6" if final else "heygen-avatar-6-turbo"
PRICE_PER_SECOND = { # credits, 1 credit = $0.005
("heygen-avatar-6-turbo", "1080p"): 10,
("heygen-avatar-6-turbo", "2K"): 18,
("heygen-avatar-6", "1080p"): 20,
("heygen-avatar-6", "2K"): 29,
}
def estimate_credits(model: str, resolution: str, audio_seconds: float) -> float:
return math.ceil(audio_seconds) * PRICE_PER_SECOND[(model, resolution)]
estimate_credits est exact pour les requêtes audio, facturées sur la durée de l’audio arrondie à l’entier supérieur. Pour les requêtes texte, ce n’est qu’une estimation, car la durée facturée est celle de la vidéo finale.
Questions fréquentes
Quelle est la différence entre la HeyGen Avatar 6 API et HeyGen Avatar 6 Turbo ?
Le prix et le niveau HeyGen. Les champs, les modes, les limites, les avatars et les voix sont identiques. Turbo coûte 10 crédits ($0.05) par seconde en 1080p contre 20 ($0.10), et 18 ($0.09) en 2K contre 29 ($0.145).
HeyGen Avatar 6 Turbo est-il plus rapide ?
Le rapport technique et la documentation développeur de HeyGen ne publient aucun chiffre de latence pour l’un ou l’autre niveau. Lors de nos deux exécutions du jour du lancement, les deux ont pris environ 2 à 2.4 minutes pour un court extrait, avec des scripts différents : mesurez donc la vitesse sur vos propres requêtes.
Puis-je passer de Turbo à Avatar 6 sans modifier ma requête ?
Oui. Changez model de heygen-avatar-6-turbo à heygen-avatar-6 ; tout ce qui se trouve dans input reste valide.
HeyGen Avatar 6 Turbo prend-il en charge le 2K ?
Oui, avec "resolution": "2K", à 18 crédits ($0.09) par seconde.
Par quel niveau de la HeyGen Avatar 6 API commencer ?
Commencez sur Turbo pendant que vous ajustez les scripts, les prompts et le choix de l’avatar, puis envoyez les rendus finaux à heygen-avatar-6. Le tutoriel texte vers avatar est un point de départ peu coûteux.