modèles

HeyGen: Avatar IV

Markdown · JSON

HeyGen: Avatar IV

Avatar IV anime une photo en vidéo parlante avec synchronisation labiale, les expressions du visage et le rythme des gestes étant guidés par la voix. HeyGen documente des processus à partir d’un script ou d’un audio enregistré et des contrôles de mouvement Photo Avatar pour des présentateurs réalistes ou stylisés.

À propos du modèle

Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.

Avatar IV est le moteur d’avatars de HeyGen qui transforme une image fixe en vidéo parlante expressive. Sa conception audio-vers-expression inspirée de la diffusion utilise le ton, le rythme et l’émotion de la voix pour guider les mouvements du visage, les inclinaisons de tête, les pauses et les micro-expressions. Son but est de produire un présentateur ou un personnage qui prononce un contenu avec synchronisation labiale et gestes, plutôt qu’un générateur de scènes généraliste qui crée un décor et une bande-son complets à partir d’un prompt cinématographique.

Le producteur décrit la prise en charge de personnages réalistes et stylisés, notamment les images de trois quarts ou de profil, les visages de style anime et les animaux de compagnie. Les personnages issus de photos fonctionnent mieux lorsque leurs yeux, leur bouche et la structure du visage sont faciles à identifier. HeyGen recommande une image nette et bien éclairée, avec une posture naturelle et des mains visibles lorsque les gestes comptent. Un visage très petit, des lèvres masquées, des masques couvrants, un bec prononcé ou des proportions très exagérées peuvent affaiblir les mouvements du visage et la synchronisation labiale. Adaptez le cadrage source à l’interprétation prévue.

Le producteur propose deux voies d’entrée pour la parole. Un script écrit est associé à une voix choisie ; une piste audio préenregistrée fournit directement la voix et les temps. Utilisez la voie audio enregistré lorsque l’interprétation est déjà définie, et la voie script lorsque la parole doit être synthétisée. Ces entrées constituent des alternatives dans l’interface documentée. Préparez le texte final, les noms et la prononciation avant l’animation et conservez l’audio ou le script avec la vidéo renvoyée afin de vérifier le résultat parlé.

Le profil de modèle Avatar IV de HeyGen couvre les avatars de studio, les Digital Twins, les Photo Avatars, les images directes et les sujets créés par prompt. Un Photo Avatar réutilisable fournit un sujet stable pour les vidéos suivantes, tandis qu’un processus à partir d’une image directe commence par l’image fournie. Le profil Photo Avatar du producteur propose des instructions de mouvement en texte libre et les choix d’expressivité high, medium ou low, avec low par défaut. Conservez l’apparence d’avatar et le moteur choisis lorsque vous créez une série, afin qu’un changement d’image source ou de modèle de rendu ne transforme pas le présentateur sans que vous le remarquiez.

Pour diriger le mouvement, décrivez une action corporelle visible et sa qualité émotionnelle. « Hoche doucement la tête avec un sourire chaleureux » donne un geste et une expression ; une brève salutation peut utiliser un signe de la main amical. Le producteur recommande un geste principal, éventuellement accompagné d’une expression du visage, et au maximum deux propositions courtes pour une séquence. Avatar IV gère le rythme à partir de l’interprétation ; le guide Studio n’exige donc pas de calendrier des gestes seconde par seconde. Une formulation précise et concise est plus facile à examiner que plusieurs actions concurrentes dans un même prompt.

Le profil audio-vers-vidéo du producteur effectue le rendu d’un maximum de trente minutes d’audio fourni par requête, et les fichiers MP3 ou WAV téléversés ont une limite de 32 Mo. Pour un cours ou un enregistrement plus long, divisez les matériaux à des limites de parole cohérentes et conservez l’ordre original. Les temps parlés de la vidéo finale doivent suivre l’audio choisi, plutôt qu’une estimation de durée de clip sans rapport.

Les réglages de sortie documentés du producteur comprennent la 720p ou la 1080p et les formats 16:9, 9:16, 4:5, 5:4 ou 1:1, avec une option automatique qui suit les proportions de la source. L’ajustement cover peut recadrer le sujet ; contain fait tenir le sujet entier et peut laisser l’arrière-plan environnant visible. Le processus audio-vers-vidéo renvoie un MP4 par défaut. Pour les avatars vidéo, une sortie WebM transparente nécessite la prise en charge du détourage, et le producteur supprime l’arrière-plan pour cette sortie au lieu de la combiner avec un nouveau fond. Examinez le cadrage réel et le fichier avant de placer le présentateur dans une composition plus grande.

Une introduction de formation peut utiliser une image de présentateur lisible, une explication concise et un geste mesuré au moment de la consigne essentielle. Une explication de produit peut conserver la même apparence d’avatar tout en changeant le script parlé selon les fonctionnalités. Le producteur documente aussi des fichiers de sous-titres facultatifs et des sous-titres incrustés ; vérifiez leur texte et leurs temps en même temps que la parole. Le rendu est asynchrone dans l’interface du producteur : une réponse de création et la vidéo terminée sont donc des livrables différents. Conservez l’enregistrement fini et son état d’achèvement avec le résultat de la tâche.

Avatar IV reste distinct du mouvement guidé par références d’Avatar V et de ses contrôles de préréglages Studio séparés. Il est aussi distinct de la génération de scènes généraliste de HeyGen Video et d’une conversation avec un avatar interactif en direct. Vérifiez les mouvements de bouche rendus, les mains visibles, les expressions du visage, les pauses et les mots prononcés par rapport aux matériaux sources et au ton souhaité. L’image, la pose, l’éclairage et les instructions de mouvement influencent le résultat ; une animation issue d’une photo doit être examinée comme une interprétation générée, en conservant les entrées choisies pour les révisions ultérieures.

Ailoot Ultra · Vidéo POST /v1/videos heygen/avatar-iv

heygen/avatar-iv

HeyGen /heygen/avatar-iv

Premiers pas

Avatar IV anime une photo en vidéo parlante avec synchronisation labiale, les expressions du visage et le rythme des gestes étant guidés par la voix. HeyGen documente des processus à partir d’un script ou d’un audio enregistré et des contrôles de mouvement Photo Avatar pour des présentateurs réalistes ou stylisés.

Entrées acceptées
Texte · Images · Audio · Vidéo
Résultats
Vidéo

Disponible dans Ailoot · entrées et méthodes

Ailoot Ultra · Vidéo POST /v1/videos
Types d’entrée
text, image, audio, video
Types de sortie
video
ChampTypeExigenceValeurs et limitesPar défaut
ChampmodelTypestringExigenceObligatoireValeurs et limites
heygen/avatar-iv
Par défaut—
Champinput_referencesTypearrayExigenceObligatoireValeurs et limites
Nombre minimal d’éléments: 2
Nombre maximal d’éléments: 2
Par défaut—
ChamppromptTypestringExigenceFacultatifValeurs et limitesPar défaut—
Paramètres et cycle de vie de la méthode
ParamètreContrat
Paramètrecontent_typeContratapplication/json
ParamètrerequiredContratmodel, input_references
Paramètrematerial_typesContrattext, image, audio, video
Paramètrematerial_conditionsContratUtilisez les URL de contenu réelles de ressources média terminées vous appartenant, avec les signatures renvoyées : une source vidéo pour BFL, ou une source image et une source audio pour avatar. La preuve du propriétaire, du type et des octets dans Source est requise., Fournissez exactement une ressource image PNG/JPEG et une ressource audio WAV/MP3. L’audio occupe au plus 32000000 octets, avec une durée supérieure à 0 et au plus égale à 1800 secondes.

Cycle de vie : asynchronous_job_then_owned_outputs

GET /v1/videos/{request_id} · id ou polling_url réellement renvoyé

GET /v1/videos/{request_id}/content

Tarifs

Calcul du coût final

Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.

Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.

Mode rapide
Non précisé Lorsque le mode rapide est sélectionné
Mode Flex
Non précisé Lorsque le mode flex est sélectionné
Effort de raisonnement maximal
Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)

Tarifs estimés à des fins de comparaison

Prix par configuration

Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.

ConfigurationBarème tarifaireQuantité prévisionnelleUnité de facturationConditions de facturationCoût
ConfigurationTarifs de base par jetonBarème tarifaireTarif de baseQuantité prévisionnelle—Unité de facturation—Conditions de facturation—Coût
Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement — / 1K tokens
Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement — / 1K tokens
Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K tokens
Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K tokens
Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K tokens
ConfigurationTarif vidéoBarème tarifaire—Quantité prévisionnelle—Unité de facturationpar seconde de vidéoConditions de facturationCette clé de tarification ne déclare aucune condition supplémentaire.Coût
Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement $0.1 par seconde de vidéo
ConfigurationCoût de génération estiméBarème tarifaire—Quantité prévisionnelleEstimation pour une générationUnité de facturation—Conditions de facturation—Coût
Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.1 estimation avant génération

Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée.

Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →

Exemples de requêtes

Ailoot Ultra · Vidéo

Utilisez les données d’entrée réelles et conservez le résultat complet
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'heygen/avatar-iv', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.

Recevoir et enregistrer les résultats

Ailoot Ultra · Vidéo

  • GET /v1/videos/{request_id}
  • GET /v1/videos/{request_id}/content
Enregistrer toutes les ressources terminées
GET toutes les ressources terminées
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
    if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
    u=urljoin("https://api.ailoot.ai",x)
    z=urlsplit(u)
    if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
    urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
  curl --fail-with-body --silent --show-error "$asset_url" \
    -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
  index=$((index + 1))
done < asset-urls.txt
Conserver tous les résultats terminés

Enregistrez chaque vidéo terminée ou fichier renvoyé ; récupérez chaque URL de ressource effectivement renvoyée.

Conservez la réponse complète et les en-têtes, chaque sortie effective, les identifiants initialement renvoyés et tous les champs d’utilisation. Récupérez l’opération d’origine sans soumettre à nouveau sa création.

Si la réponse d’origine doit être vérifiée

Conservez X-Client-Request-ID, X-Ailoot-Task-Id et les valeurs id/polling_url réellement renvoyées. Poursuivez la tâche d’origine ; ne soumettez pas à nouveau sa création.

Champs de la réponse
ChampType
ChampidType
ChampstatusType
Champdata[]Type
Champoutputs[]Type

Alias

Alias du modèle

Ailoot Ultra heygen/avatar-iv

Alias des chemins de méthode

Utilisez les chemins de méthode indiqués ci-dessus.

ID d’appel associés

heygen/avatar-iv

FAQ · HeyGen: Avatar IV
Quelles entrées et quels résultats sont disponibles ?

POST /v1/videos · heygen/avatar-iv: text, image, audio, video → video

Quels champs la requête utilise-t-elle ?

POST /v1/videos · heygen/avatar-iv: model, input_references, prompt

Plus de détails

Connectez Ailoot à Claude Code, OpenCode, Hermes ou à votre application.

L’entreprise et son portefeuille de projets

L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.

Achetez des tokens à prix réduit.

Une remise d’abonnement pour le travail régulier. Des codes promo jusqu’à 50% sur l’achat de tokens.

Abonnement
Choisissez une offre à tarif réduit pour vos requêtes régulières.
Code promo jusqu’à 50%
Saisissez le code à l’achat. Le prix est recalculé selon la promotion en cours.
Dépenses dans l’historique
Modèle, tokens et montant sont enregistrés pour chaque requête.

Choisir un abonnement · Voir les prix des modèles

Connectez l’API au produit que vous vendez.

SaaS, applications et bots selon l’offre officielle et le contrat de licence Ailoot. Pour la revente, demandez une licence revendeur.

Application commerciale
Intégrez la génération de texte, d’images, de vidéo et de son aux fonctions payantes de votre service.
Licence revendeur
Envoyez la description du projet et le mode d’accès. Demandez des conditions écrites d’utilisation et de revente.
Documents sur le site
L’offre officielle, le contrat de licence et la politique de traitement des données sont accessibles avant connexion.

Demander une licence revendeur · Offre officielle et contrat de licence