Accéder 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Fichiers comme dans l'exemple: 3,00 $ 3 000 crédits API · ≈ 322,74 ₽ 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 prédéfini

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.

•obligatoire 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, pointant vers un fichier contenant exactement un flux vidéo et au moins un segment approprié d’une seconde servant 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 rapport de l’image 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 de stock 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 tous deux ce champ non défini. L’audio n’est jamais fourni par ce visuel et provient toujours de audio_url. Pour choisir un 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 ; la fourniture de video_reference_url entraîne son ignorance. 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 rapport de l’image 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.ru/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.ru/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 sur les lèvres à partir de `audio_url` (3 à 180 secondes). Le visuel provient de `video_reference_url`, `image_reference_url` ou d’un `avatar` prédéfini ; la référence vidéo est prioritaire sur l’image lorsque les deux sont fournies. L’option avatar fournit uniquement les visuels, 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_urlobligatoire 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, pointant vers un fichier contenant exactement un flux vidéo et au moins un segment approprié d’une seconde servant 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 rapport de l’image 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 de stock 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 tous deux ce champ non défini. L’audio n’est jamais fourni par ce visuel et provient toujours de audio_url. Pour choisir un 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 ; la fourniture de video_reference_url entraîne son ignorance. 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 rapport de l’image doit être à moins de 5 % de 9:16 ou 16:9.
obligatoire 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie sur notre stockage : conservée indéfiniment (facturation par Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Une structure identique pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et l'audio. output est l'objet de résultat propre au 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 à l'adresse https://doitong.com/fr-FR/developers/models/mirage-api/avatar-x/reference-to-video.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt