Passer au contenu

Mirage Avatar X

Intégrer

Identifiant du modèle mirage-api/avatar-x/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/mirage-api/avatar-x/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Fichiers comme dans l’exemple: 3,00 $ 3 000 crédits API vos fichiers sont mesurés avant l’exécution L’exécuter sur cette page

Obtenir une clé API
Mirage Synchronisation labiale et avatars Entrées de référenceSynchronisation labiale #avatar#lipsync#talking-head

Vidéo d’avatar parlant Avatar X pilotée par votre audio et une image, une vidéo ou une référence d’avatar de catalogue

Mirage · Vidéo

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

•requis audio_url
Déposez un fichier, ou

Adresse HTTPS publique de l’audio qui anime la vidéo générée, accessible sans en-têtes d’autorisation ni cookies. Les formats audio acceptés sont FLAC, Opus ou Vorbis, AAC ou ALAC, PCM WAV ou AIFF, et MP3. Le fichier doit contenir un seul flux mono ou stéréo, durer de 3 à 180 secondes, occuper au maximum 64 MiB et avoir une fréquence d’échantillonnage de 8 à 48 kHz.

Avancé video_reference_url · avatar · image_reference_url

URL HTTPS publique de la vidéo de référence, accessible sans en-têtes d’autorisation ni cookies, vers un fichier contenant exactement un flux vidéo et au moins un segment adapté d’une seconde pour servir de référence ; l’audio est ignoré. Les fichiers acceptés associent .mp4, .mov ou .m4v à H.264, H.265/HEVC ou ProRes, ou utilisent .webm avec VP8 ou VP9 ; la durée doit être comprise entre 1 et 120 secondes, la taille ne doit pas dépasser 1 GiB et le ratio d’affichage doit être à moins de 5 % de 9:16 ou 16:9. Si image_reference_url est également fourni, la vidéo est prioritaire.

Sélection visuelle prédéfinie utilisée uniquement lorsqu’aucune référence d’image ou de vidéo n’est fournie ; None et la valeur par défaut laissent le champ vide. L’audio n’est jamais fourni par cet élément visuel et provient toujours de audio_url. Pour choisir un élément visuel, consultez les options dans le [catalogue d’avatars](https://captions.ai/help/docs/api/actor-catalog) et copiez sa valeur Avatar exacte.

URL HTTPS publique de l’image de référence, accessible sans cookies ni en-têtes d’autorisation ; fournir video_reference_url entraîne son ignore. Accepte une seule image statique au format .jpg, .jpeg, .png ou .webp, limitée à 25 MiB et 25 mégapixels. Le bord le plus court doit mesurer au moins 512 px et aucun bord ne peut dépasser 8192 px ; le ratio doit être à moins de 5 % de 9:16 ou 16:9.

POST /run/mirage-api/avatar-x/reference-to-video?wait=20 devis → 3,00 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/mirage-api/avatar-x/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Mirage Avatar X

Crée une vidéo d’avatar synchronisée avec les lèvres à partir de `audio_url` (3 à 180 secondes). Le visuel provient de `video_reference_url`, `image_reference_url` ou d’un `avatar` de catalogue ; la référence vidéo est prioritaire sur l’image lorsque les deux sont fournies. L’option avatar fournit uniquement le visuel, pas l’audio. Les URL de référence doivent être accessibles publiquement via HTTPS.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
audio_urlrequis audio
Typeurl · audio
Adresse HTTPS publique de l’audio qui anime la vidéo générée, accessible sans en-têtes d’autorisation ni cookies. Les formats audio acceptés sont FLAC, Opus ou Vorbis, AAC ou ALAC, PCM WAV ou AIFF, et MP3. Le fichier doit contenir un seul flux mono ou stéréo, durer de 3 à 180 secondes, occuper au maximum 64 MiB et avoir une fréquence d’échantillonnage de 8 à 48 kHz.
video_reference_urlfacultatif
Typestring | null
URL HTTPS publique de la vidéo de référence, accessible sans en-têtes d’autorisation ni cookies, vers un fichier contenant exactement un flux vidéo et au moins un segment adapté d’une seconde pour servir de référence ; l’audio est ignoré. Les fichiers acceptés associent .mp4, .mov ou .m4v à H.264, H.265/HEVC ou ProRes, ou utilisent .webm avec VP8 ou VP9 ; la durée doit être comprise entre 1 et 120 secondes, la taille ne doit pas dépasser 1 GiB et le ratio d’affichage doit être à moins de 5 % de 9:16 ou 16:9. Si image_reference_url est également fourni, la vidéo est prioritaire.
avatarfacultatif
Typeenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 de plusNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Sélection visuelle prédéfinie utilisée uniquement lorsqu’aucune référence d’image ou de vidéo n’est fournie ; None et la valeur par défaut laissent le champ vide. L’audio n’est jamais fourni par cet élément visuel et provient toujours de audio_url. Pour choisir un élément visuel, consultez les options dans le [catalogue d’avatars](https://captions.ai/help/docs/api/actor-catalog) et copiez sa valeur Avatar exacte.
image_reference_urlfacultatif
Typestring | null
URL HTTPS publique de l’image de référence, accessible sans cookies ni en-têtes d’autorisation ; fournir video_reference_url entraîne son ignore. Accepte une seule image statique au format .jpg, .jpeg, .png ou .webp, limitée à 25 MiB et 25 mégapixels. Le bord le plus court doit mesurer au moins 512 px et aucun bord ne peut dépasser 8192 px ; le ratio doit être à moins de 5 % de 9:16 ou 16:9.
requis Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "mirage-api/avatar-x/reference-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 3000,
    "usd": "3.00",
    "charged": 3000,
    "refunded": 0
  },
  "input": {
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation au Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, vidéos et fichiers audio. output est le propre objet de résultat du modèle.
Champs de sortie
video
object {url, content_type, file_name, file_size}

Plus de modèles : Synchronisation labiale et avatars

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/mirage-api/avatar-x/reference-to-video.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt