Source: https://ailoot.ai/models/fr-be/heygen-heygen-video-1/
Canonical: https://ailoot.ai/models/fr-be/heygen-heygen-video-1/
Language: fr-be

# HeyGen: HeyGen Video

[Markdown](https://ailoot.ai/models/fr-be/heygen-heygen-video-1/index.md) · [JSON](https://ailoot.ai/models/fr-be/heygen-heygen-video-1/facts.json)

## [HeyGen: HeyGen Video](https://ailoot.ai/models/fr-be/heygen-heygen-video-1/)

HeyGen Video génère des scènes de 5 à 15 secondes avec dialogue, ambiance et effets à partir de texte, d’une première image ou de références visuelles et sonores. Son modèle généraliste heygen-video-1 prend en charge les plans de produits et de personnages, avec des contrôles de références et une sortie MP4. Des actions claires et circonscrites lui fournissent un brief de production utile.

- [**Ailoot Ultra · Vidéo** `POST /v1/videos` `heygen/heygen-video-1`](https://ailoot.ai/models/fr-be/heygen-heygen-video-1/#method-0)

À 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.

HeyGen Video est le modèle généraliste de génération de scènes de HeyGen, identifié par le producteur sous le nom heygen-video-1. Il crée ensemble le sujet, le décor, la lumière et le son à partir d’un brief créatif. Chaque clip dure de 5 à 15 secondes et contient sa piste audio générée, notamment les dialogues, l’ambiance et les effets. Les entrées utiles à la production comprennent une description de scène, une photographie de produit ou des matériaux qui définissent une personne, un lieu ou un mouvement. Le fichier obtenu est une courte scène pour une présentation de produit, un insert d’accueil, une vue immobilière ou d’autres travaux de montage vidéo.

Trois modes donnent des rôles différents aux entrées. La génération à partir de texte crée une scène à partir du prompt. La génération à partir d’une image commence exactement sur l’image fournie, puis suit le brief pour l’action. La génération à partir de références utilise des images, des vidéos et éventuellement du son pour guider une scène nouvellement composée ; elle exige au moins une image ou une vidéo de référence. Choisissez une image de départ lorsque la composition d’ouverture doit correspondre à une image fixe, ou des références lorsqu’un objet connu doit apparaître dans une composition différente. Ce modèle de scène est distinct des moteurs de rendu d’avatars de HeyGen et du processus de composition Video Agent.

Le guide du producteur privilégie des consignes de plan détaillées et concrètes : un sujet, un lieu et une action circonscrite, avec une caméra fixe ou en mouvement doux. Décrivez la position de la caméra, l’objectif ou l’intention de profondeur de champ, la lumière, la texture des surfaces et le traitement des couleurs. Expliquez les points de contact entre les objets lorsqu’une action en dépend. Pour un exemple de produit, utilisez une photographie de référence d’une gourde de voyage et demandez qu’elle soit posée sur un comptoir en bois pendant qu’un présentateur parle à côté, avec un petit mouvement de caméra vers la gourde. Vérifiez sa forme, son emplacement et ses inscriptions visibles dans le résultat.

Les listes de références acceptent jusqu’à neuf images, trois vidéos et trois éléments audio, avec un maximum de douze références au total. Les images, vidéos et éléments audio sont numérotés séparément dans le format de prompt du producteur : la première image est \<Picture 1\> et la première vidéo \<Video 1\>. Donnez un rôle à chaque référence et identifiez-le explicitement dans le brief. Le modèle lit les cinq premières secondes de chaque vidéo de référence : préparez donc la partie pertinente au début. La référence API précise aussi des proportions de vidéo de référence comprises entre 1:4 et 4:1. Un long clip dont le mouvement souhaité n’apparaît qu’à la fin constitue une mauvaise préparation pour cette fenêtre d’entrée de cinq secondes.

L’interface de références documentée accepte une ressource HTTPS directement accessible, un identifiant de fichier téléversé ou des données base64 intégrées. Le guide indique des tailles maximales d’image de 16 Mo par URL et de 5 Mo en données intégrées ; une vidéo ou un élément audio peut atteindre 32 Mo par URL et 16 Mo en données intégrées. Préparez des sources lisibles où le sujet important se distingue facilement, sans consignes concurrentes entre les références. Conservez l’orientation souhaitée dans l’image initiale. Ces détails d’entrée concernent le processus de références du producteur et aident à organiser les matériaux créatifs pour le mode choisi.

Dirigez le son dans le même brief que l’image. Précisez le dialogue, l’interprétation vocale, l’ambiance de la pièce et les effets particuliers, notamment si un son doit être proche ou lointain. Indiquez le traitement musical souhaité lorsque la scène doit contenir uniquement de la parole et de l’ambiance. Le guide propose environ 2,5 mots parlés par seconde comme estimation de préparation : laissez donc de la place aux pauses et à l’action visible. Une courte introduction peut se préparer comme une réplique suivie d’un temps qui révèle le produit. Écoutez les mots réellement prononcés et vérifiez que le son généré correspond à l’espace et à l’action.

La durée de sortie se choisit en secondes entières de cinq à quinze, avec cinq secondes par défaut. La résolution est une classe de dimensions : 480p, 768p, 1080p ou 2k. Les choix de cadrage documentés sont 21:9, 16:9, 4:3, 1:1, 3:4 et 9:16. Pour la génération à partir de texte ou de références en 1080p ou 2k, sélectionnez 16:9 ou 9:16 ; le cadrage adaptatif des références est documenté en 480p et 768p. La génération à partir d’une image suit les proportions de la première image : recadrez-la donc avant la génération si le format demandé change. Vérifiez les dimensions réelles du résultat terminé, au lieu de supposer qu’une classe de dimensions implique une paire de dimensions conventionnelle en pixels.

Le guide du modèle précise une vidéo MP4 avec encodage d’image H.264 et son AAC à 32 kHz en stéréo. Une génération est traitée de manière asynchrone, et la tâche terminée fournit l’adresse de la vidéo lisible, sa durée et ses dimensions. Son adresse vidéo signée peut être renouvelée en consultant de nouveau la tâche. Conservez le clip lui-même, les références et le brief pour la revue de montage. Un enregistrement en attente ou en cours de traitement suit la génération ; la vidéo terminée est le livrable de production à évaluer pour l’image, la parole et le son.

Le producteur documente les choix d’amélioration du prompt turbo, quality et disabled ; disabled conserve la formulation préparée telle quelle. Un seed fixe est utile pour comparer le changement d’une proposition en conservant les autres entrées. Notez le seed et les réglages choisis avec le brief du plan. Pour les inscriptions à l’écran, gardez la phrase souhaitée courte et écrivez-la avec précision ; le guide recommande d’ajouter ensuite au montage les paragraphes, les petits caractères et les schémas annotés. Vérifiez chaque caractère visible d’un titre généré au lieu de supposer que le texte a été reproduit correctement.

Le guide identifie les longs textes à l’écran, les mouvements organiques souples comme ceux des pétales, du papier ou des cheveux, et les manipulations de mains en gros plan comme des domaines moins fiables. Pour une explication de procédure, laissez une réplique clairement écrite transmettre les étapes pendant que l’image montre une personne ou un objet stable ; utilisez des visuels vérifiés séparément lorsque l’opération physique elle-même doit être exacte. Examinez tout le plan pour la continuité des objets, les contacts, les détails du visage et des mains, le dialogue et le son. Une liste concise des changements à apporter à la prise suivante garde un brief de production détaillé utilisable.

**Ailoot Ultra · Vidéo** `POST /v1/videos` `heygen/heygen-video-1`

[`heygen/heygen-video-1`](https://ailoot.ai/models/fr-be/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

HeyGen /`heygen/heygen-video-1`

### Premiers pas

HeyGen Video génère des scènes de 5 à 15 secondes avec dialogue, ambiance et effets à partir de texte, d’une première image ou de références visuelles et sonores. Son modèle généraliste heygen-video-1 prend en charge les plans de produits et de personnages, avec des contrôles de références et une sortie MP4. Des actions claires et circonscrites lui fournissent un brief de production utile.

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`

Entrée

`text`, `image`, `audio`, `video`

Sortie

`video`

Format de sortie

Octets MP4 d’origine ; sans normalisation ni transcodage

| Champ | Type | Exigence | Valeurs et limites | Par défaut |
| --- | --- | --- | --- | --- |
| Champ`model` | Type`string` | ExigenceObligatoire | Valeurs et limites heygen/heygen-video-1 | Par défaut— |
| Champ`prompt` | Type`string` | ExigenceObligatoire | Valeurs et limites | Par défaut— |
| Champ`duration` | Type`integer` | ExigenceObligatoire | Valeurs et limites 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Par défaut— |
| Champ`resolution` | Type`string` | ExigenceFacultatif | Valeurs et limites 480p, 768p, 2K | Par défaut— |
| Champ`aspect_ratio` | Type`string` | ExigenceFacultatif | Valeurs et limites 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Par défaut— |
| Champ`generate_audio` | Type`boolean` | ExigenceFacultatif | Valeurs et limites false | Par défaut— |
| Champ`frame_images` | Type`array` | ExigenceFacultatif | Valeurs et limites Nombre minimal d’éléments: 1 Nombre maximal d’éléments: 1 Contenu en entrée: Tableau d’objets représentant les images de la séquence. Chaque objet comporte type=image\_url, image\_url contenant url et frame\_type. Utilisez une URL d’image HTTPS et définissez frame\_type sur first\_frame. Chaque rôle d’image apparaît au plus une fois. Clés exactes: type, image\_url, frame\_type Conditions: Ces clés décrivent chaque objet représentant une image de la séquence ; image\_url contient uniquement url. Omettez frame\_images pour une requête contenant uniquement du texte. | Par défaut— |
| Champ`input_references` | Type`array` | ExigenceFacultatif | Valeurs et limites | Par défaut— |
| Champ`seed` | Type`integer` | ExigenceFacultatif | Valeurs et limites Minimum: -9 223 372 036 854 775 808 Maximum: 9 223 372 036 854 775 807 | Par défaut— |
| Champ`callback_url` | Type`string` | ExigenceFacultatif | Valeurs et limites Motif: ^https:// | Par défaut— |
| Champ`session_id` | Type`string` | ExigenceFacultatif | Valeurs et limites | Par défaut— |
| Champ`trace` | Type`object` | ExigenceFacultatif | Valeurs et limites | Par défaut— |
| Champ`user` | Type`string` | ExigenceFacultatif | Valeurs et limites | Par défaut— |

Combinaisons d’éléments d’entrée

**Texte vers vidéo** · Une consigne écrite. · Obligatoire : model, prompt, duration

`Fournissez prompt sous forme de texte et duration en secondes entières. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.`

`model`: Type : string · heygen/heygen-video-1

`prompt`: Type : string · Nombre maximal d’octets UTF-8: 10 000 · Caractères autres que des espaces requis: Oui

**Image vers vidéo** · Une consigne écrite et une image de début de séquence. · Obligatoire : model, prompt, duration, frame\_images

`frame_images est un tableau. Chaque objet représentant une image de la séquence comporte type, image_url et frame_type ; image_url contient url. Définissez type sur image_url. Utilisez first_frame. Chaque rôle d’image apparaît au plus une fois. Fournissez une URL d’image HTTPS publique pour chaque image de la séquence. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.`

Clés exactes : type, image\_url, frame\_type

`model`: Type : string · heygen/heygen-video-1

`prompt`: Type : string · Nombre maximal d’octets UTF-8: 10 000 · Caractères autres que des espaces requis: Oui

**Reference to video** · Une consigne écrite et des références image, vidéo ou audio prises en charge. · Obligatoire : model, prompt, duration, input\_references

`input_references est un tableau d’objets. Définissez type sur image_url, video_url ou audio_url, puis utilisez le champ correspondant contenant url. Utilisez des URL HTTPS publiques. Omettez frame_images pour sélectionner le mode avec références. Choisissez une résolution prise en charge et, si nécessaire, un rapport largeur/hauteur.`

`model`: Type : string · heygen/heygen-video-1

`prompt`: Type : string · Nombre maximal d’octets UTF-8: 10 000 · Caractères autres que des espaces requis: Oui

Paramètres et cycle de vie de la méthode

| Paramètre | Contrat |
| --- | --- |
| Paramètre`content_type` | Contratapplication/json |
| Paramètre`required` | Contratmodel, prompt, duration |
| Paramètre`material_types` | Contrattext, image, audio, video |
| Paramètre`additional_properties` | Contratfalse |
| Paramètre`optional_controls` | Contratresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, seed, callback\_url, session\_id, trace, user |

Cycle de vie : `submit_once_poll_original`

`GET /v1/videos/{public_id}`

`GET /v1/videos/{public_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.

| Configuration | Barème tarifaire | Quantité prévisionnelle | Unité de facturation | Conditions de facturation | Coût |
| --- | --- | --- | --- | --- | --- |
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité 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éo | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar seconde de vidéo | Conditions de facturationresolution: 2k | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement **$0.2** par seconde de vidéo |
| ConfigurationTarif vidéo | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar seconde de vidéo | Conditions de facturationresolution: 480p | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement **$0.04** par seconde de vidéo |
| ConfigurationTarif vidéo | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar seconde de vidéo | Conditions de facturationresolution: 768p | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement **$0.072** par seconde de vidéo |
| ConfigurationTarif vidéo | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar seconde de vidéo | Conditions de facturationmode de génération : reference ; résolution : 2k | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement **$0.36** par seconde de vidéo |
| ConfigurationTarif vidéo | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar seconde de vidéo | Conditions de facturationmode de génération : reference ; résolution : 480p | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement **$0.14** par seconde de vidéo |
| ConfigurationTarif vidéo | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar seconde de vidéo | Conditions de facturationmode de génération : reference ; résolution : 768p | Coût Sortie · Tarif vidéo · Estimation à des fins de comparaison uniquement **$0.2** par seconde de vidéo |
| Configurationimage de référence en entrée | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar image de référence en entrée | Conditions de facturation— | Coût Entrée · image de référence en entrée · Estimation à des fins de comparaison uniquement **$0.08** par image de référence en entrée |
| ConfigurationCoût estimé de la génération | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Unité de facturation— | Conditions de facturation— | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement **$0.2** 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 →](https://ailoot.ai/docs/fr-be/billing/reserve/)

#### Détails du tarif de référence

Les barèmes de référence du modèle ne modifient ni la sélection de méthode, ni les devis, ni les coûts. Les frais actifs utilisent les tarifs de la méthode Ailoot sélectionnée.

Références tarifaires des configurations vidéo

#### Prix par configuration

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

| Configuration | Conditions de facturation | Coût |
| --- | --- | --- |
| ConfigurationTarif vidéo | Conditions de facturationresolution: 2k | Coût Sortie · Tarif vidéo **$0.18** par seconde de vidéo Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée. |
| ConfigurationTarif vidéo | Conditions de facturationresolution: 480p | Coût Sortie · Tarif vidéo **$0.04** par seconde de vidéo Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée. |
| ConfigurationTarif vidéo | Conditions de facturationresolution: 768p | Coût Sortie · Tarif vidéo **$0.06** par seconde de vidéo Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée. |
| ConfigurationTarif vidéo | Conditions de facturationmode de génération : reference ; résolution : 2k | Coût Sortie · Tarif vidéo **$0.36** par seconde de vidéo Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée. |
| ConfigurationTarif vidéo | Conditions de facturationmode de génération : reference ; résolution : 480p | Coût Sortie · Tarif vidéo **$0.08** par seconde de vidéo Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée. |
| ConfigurationTarif vidéo | Conditions de facturationmode de génération : reference ; résolution : 768p | Coût Sortie · Tarif vidéo **$0.12** par seconde de vidéo Tarif publié de référence pour la configuration affichée. Les frais définitifs correspondent à la configuration réellement facturée. |

### Exemples de requêtes

#### Ailoot Ultra · Vidéo

curl · créer une vidéo

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"heygen/heygen-video-1","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', 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 result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

### Recevoir et enregistrer les résultats

#### Ailoot Ultra · Vidéo

URL de contenu signées dont vous êtes propriétaire

- `GET /v1/videos/{public_id}`
- `GET /v1/videos/{public_id}/content`

##### Vérifier l’état de la tâche

GET état de l’opération d’origine

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

Autres lectures de contenu

Enregistrer chaque sortie terminée dont vous êtes propriétaire

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
```

##### 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 chaque résultat réel dont vous êtes propriétaire ainsi que les métadonnées mesurées renvoyées avec celui-ci.

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

503 result\_pending\_check + originalid + X-Should-Retry:false ; ne rejouez jamais la requête d’origine

Champs de la réponse

| Champ | Type | Signification |
| --- | --- | --- |
| Champ`index` | Typeinteger | SignificationPosition de cette vidéo dans la liste des résultats, avec une numérotation commençant à zéro. |
| Champ`content_url` | Typestring | SignificationURL de téléchargement HTTPS signée pour cette vidéo terminée. |
| Champ`sha256` | Typestring \| null | SignificationEmpreinte SHA-256 des octets vidéo d’origine ; null si elle est indisponible. |
| Champ`size_bytes` | Typeinteger \| null | SignificationTaille du fichier vidéo d’origine en octets ; null si elle est indisponible. |
| Champ`duration_ms` | Typeinteger \| null | SignificationDurée mesurée de la vidéo en millisecondes ; null si elle est indisponible. |
| Champ`width` | Typeinteger \| null | SignificationLargeur de la vidéo en pixels ; null si elle est indisponible. |
| Champ`height` | Typeinteger \| null | SignificationHauteur de la vidéo en pixels ; null si elle est indisponible. |
| Champ`video_codec` | Typestring \| null | SignificationIdentifiant du codec vidéo ; null s’il n’a pas été enregistré. |
| Champ`has_audio` | Typeboolean \| null | SignificationIndique si la vidéo contient une piste audio ; null si cela n’a pas été mesuré. |
| Champ`audio_codec` | Typestring \| null | SignificationIdentifiant du codec audio ; null lorsqu’aucun identifiant n’a été enregistré. |

Erreurs et étapes suivantes

| Réponse | Condition | Étape suivante |
| --- | --- | --- |
| Réponse404 · `not_found_error` | ConditionL’accès à la vidéo est indisponible, ou cet ID vidéo est introuvable. | Étape suivanteVérifiez l’accès à la vidéo. Pour une vidéo existante, utilisez son ID public d’origine et la même clé API. |
| Réponse401 · `authentication_error` | ConditionLa clé API ne correspond pas au compte authentifié. | Étape suivanteVérifiez votre clé API et l’accès au compte avant de soumettre la requête. |
| Réponse400 · `invalid_request_error` | ConditionLa requête n’a pas pu être lue, ou l’index de téléchargement est invalide. | Étape suivanteCorrigez le corps de la requête. Pour un téléchargement, choisissez un index de sortie renvoyé par la tâche d’origine. |
| Réponse422 · `price_unavailable` | ConditionLa configuration vidéo sélectionnée ne peut pas être tarifée. | Étape suivanteChoisissez une configuration vidéo prise en charge et renseignez ses options obligatoires avant de soumettre une requête corrigée. |
| Réponse422 · `invalid_request_error` | ConditionUne entrée vidéo ou la tâche de continuation d’origine est invalide. | Étape suivanteUtilisez des entrées HTTPS valides. Pour une continuation, utilisez l’ID vidéo public de votre résultat d’origine terminé avec la même clé API. |
| Réponse402 · `billing_error` | ConditionLe solde disponible ou les limites ne permettent pas de réserver le montant nécessaire. | Étape suivanteVérifiez votre solde disponible et vos limites avant d’envoyer une nouvelle requête. |
| Réponse503 · `server_error` | ConditionLa vérification vidéo, le stockage ou l’accès au service est temporairement indisponible. | Étape suivanteAttendez que le service soit disponible. Si vous disposez déjà d’un ID vidéo, vérifiez cette tâche d’origine au lieu de créer une autre génération. |
| Réponse503 · `result_pending_check` | ConditionLe résultat vidéo d’origine et sa facturation doivent être vérifiés. | Étape suivanteConservez l’ID vidéo renvoyé et vérifiez cette tâche. N’envoyez pas de requête de génération de remplacement pendant sa vérification. |
| Réponse503 · `owned_result_unavailable` | ConditionLe téléchargement de la vidéo existante est temporairement indisponible. | Étape suivanteVérifiez la même tâche vidéo plus tard et téléchargez son résultat existant. Une nouvelle génération crée une opération distincte. |
| Réponse409 · `video_not_ready` | ConditionLe contenu vidéo n’a pas été publié. | Étape suivanteVérifiez l’état de la tâche d’origine. Téléchargez lorsqu’il indique completed ; s’il indique failed, suivez son avis de vérification de facturation. |

### Alias

#### Alias du modèle

**Ailoot Ultra** [`heygen/heygen-video-1`](https://ailoot.ai/models/fr-be/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

#### Alias des chemins de méthode

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

#### ID d’appel associés

[`heygen/heygen-video-1`](https://ailoot.ai/models/fr-be/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

FAQ · HeyGen: HeyGen Video

Quelles entrées et quels résultats sont disponibles ?

`POST /v1/videos` · `heygen/heygen-video-1`: `text`, `image`, `audio`, `video` → `video`

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

`POST /v1/videos` · `heygen/heygen-video-1`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `seed`, `callback_url`, `session_id`, `trace`, `user`

Quelles limites s’appliquent ?

`POST /v1/videos` · `heygen/heygen-video-1`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `1`; `frame_images.min_items`: `1`; `seed.minimum`: `-9223372036854775808`; `seed.maximum`: `9223372036854775807`

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](https://ailoot.ai/docs/fr-be/billing/subscriptions/) · [Voir les prix des modèles](https://ailoot.ai/models/fr-be/)

## 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](mailto:support@ailoot.ai) · [Offre officielle et contrat de licence](https://ailoot.ai/legal/offer?lang=fr-be)

## Ailoot · L’entreprise et son portefeuille de projets





Ailoot s’appuie sur une expérience opérationnelle éprouvée, une large clientèle, un service stable et un suivi continu des KPI.





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





Ailoot met cette expérience opérationnelle au service de l’accès API aux fonctions d’IA dans les produits des clients, leurs agents, applications et automatisations.