Ir al contenido

Mirage Avatar X

Integrar

ID del modelo 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"

Archivos como el ejemplo: 3,00 $ 3000 créditos de API tus archivos se miden antes de la ejecución Ejecutar en esta página

Obtener clave de API
Mirage Sincronización labial y avatares Entradas de referenciaSincronización labial #avatar#lipsync#talking-head

Vídeo de avatar parlante Avatar X controlado por tu audio y una imagen, vídeo o referencia de avatar de stock

Mirage · Vídeo

Tu primer resultado aparecerá aquí

Crea una solicitud a continuación y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, conservadas para siempre o 7 días gratis.

Crear una solicitud

Los controles se generan a partir del esquema del modelo. El código y el precio se actualizan al modificarlos.

•obligatorio audio_url
Suelta un archivo o

Dirección HTTPS pública del audio que impulsa el vídeo generado, accesible sin encabezados de autorización ni cookies. Los formatos de audio aceptados son FLAC, Opus o Vorbis, AAC o ALAC, PCM WAV o AIFF y MP3. El archivo debe contener un único flujo mono o estéreo, durar entre 3 y 180 segundos, ocupar como máximo 64 MiB y tener una frecuencia de muestreo de 8–48 kHz.

Avanzado video_reference_url · avatar · image_reference_url

URL HTTPS del vídeo de referencia, accesible públicamente sin encabezados de autorización ni cookies, para un archivo que contenga exactamente un flujo de vídeo y al menos un segmento adecuado de 1 segundo que sirva como referencia; el audio se ignora. Los archivos aceptados son .mp4, .mov o .m4v con H.264, H.265/HEVC o ProRes, o .webm con VP8 o VP9; la duración debe ser de 1 a 120 segundos, el tamaño no debe superar 1 GiB y la relación de aspecto de visualización debe estar dentro del 5 % de 9:16 o 16:9. Si también se proporciona image_reference_url, el vídeo tiene prioridad.

Selección visual de stock utilizada solo cuando no se proporciona ninguna referencia de imagen o vídeo; None y el valor predeterminado hacen que quede sin establecer. Este elemento visual nunca proporciona audio, que siempre procede de audio_url. Para elegir un elemento visual, consulta las opciones en el [catálogo de avatares](https://captions.ai/help/docs/api/actor-catalog) y copia su valor exacto de Avatar.

URL HTTPS de la imagen de referencia, accesible públicamente sin cookies ni encabezados de autorización; proporcionar video_reference_url hace que se ignore. Acepta una única imagen estática en formato .jpg, .jpeg, .png o .webp, con un límite de 25 MiB y 25 megapíxeles. El borde más corto debe medir al menos 512 px y ninguno de los bordes puede superar 8192 px; la relación de aspecto debe estar dentro del 5 % de 9:16 o 16:9.

POST /run/mirage-api/avatar-x/reference-to-video?wait=20 presupuesto → 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"

Ejecutar esta solicitud

Tu clave permanece en este navegador: solo se envía a la Doitong API y solo se guarda en localStorage si marcas Recordar. Obtener una clave de API

Acerca de Mirage Avatar X

Crea un vídeo de avatar sincronizado labialmente a partir de `audio_url` (de 3 a 180 segundos). El contenido visual procede de `video_reference_url`, `image_reference_url` o un `avatar` de stock; la referencia de vídeo tiene prioridad sobre la imagen cuando se proporcionan ambas. La opción de avatar solo aporta elementos visuales, no audio. Las URL de referencia deben poder obtenerse públicamente mediante HTTPS.

Parámetros

Envía el nombre canónico o el nombre nativo, pero no ambos. Nombres canónicos

NombreTipo PredeterminadoPermitido Descripción
audio_urlobligatorio audio
Tipourl · audio
Dirección HTTPS pública del audio que impulsa el vídeo generado, accesible sin encabezados de autorización ni cookies. Los formatos de audio aceptados son FLAC, Opus o Vorbis, AAC o ALAC, PCM WAV o AIFF y MP3. El archivo debe contener un único flujo mono o estéreo, durar entre 3 y 180 segundos, ocupar como máximo 64 MiB y tener una frecuencia de muestreo de 8–48 kHz.
video_reference_urlopcional
Tipostring | null
URL HTTPS del vídeo de referencia, accesible públicamente sin encabezados de autorización ni cookies, para un archivo que contenga exactamente un flujo de vídeo y al menos un segmento adecuado de 1 segundo que sirva como referencia; el audio se ignora. Los archivos aceptados son .mp4, .mov o .m4v con H.264, H.265/HEVC o ProRes, o .webm con VP8 o VP9; la duración debe ser de 1 a 120 segundos, el tamaño no debe superar 1 GiB y la relación de aspecto de visualización debe estar dentro del 5 % de 9:16 o 16:9. Si también se proporciona image_reference_url, el vídeo tiene prioridad.
avataropcional
Tipoenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 másNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Selección visual de stock utilizada solo cuando no se proporciona ninguna referencia de imagen o vídeo; None y el valor predeterminado hacen que quede sin establecer. Este elemento visual nunca proporciona audio, que siempre procede de audio_url. Para elegir un elemento visual, consulta las opciones en el [catálogo de avatares](https://captions.ai/help/docs/api/actor-catalog) y copia su valor exacto de Avatar.
image_reference_urlopcional
Tipostring | null
URL HTTPS de la imagen de referencia, accesible públicamente sin cookies ni encabezados de autorización; proporcionar video_reference_url hace que se ignore. Acepta una única imagen estática en formato .jpg, .jpeg, .png o .webp, con un límite de 25 MiB y 25 megapíxeles. El borde más corto debe medir al menos 512 px y ninguno de los bordes puede superar 8192 px; la relación de aspecto debe estar dentro del 5 % de 9:16 o 16:9.
obligatorio Nombre canónico, también aceptado

Los parámetros de archivo aceptan una URL pública https://, un URI data: de hasta 10 MB o el file_url de una subida. Archivos

Salida

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"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: conservada para siempre (con pago por GB-mes) o 7 días gratis, según la configuración de tu cuenta o ?storage=.
La misma estructura en todos los modelostype, url, content_type, width, height y duration, tanto para imágenes como para vídeo y audio. output es el objeto de resultado propio del modelo.
Campos de salida
video
object {url, content_type, file_name, file_size}

Más modelos: Sincronización labial y avatares

Para agentes de IA: esta página en Markdown está en https://doitong.com/es-ES/developers/models/mirage-api/avatar-x/reference-to-video.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt