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 referencia de imagen, vídeo o avatar de catálogo

Mirage · Vídeo

Tu primer resultado aparecerá aquí

Crea una solicitud abajo 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 controla el video 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 una sola secuencia 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 pública del video de referencia, accesible sin encabezados de autorización ni cookies, para un archivo que contenga exactamente una secuencia de video y al menos un segmento adecuado de 1 segundo que sirva de referencia; el audio se ignora. Los archivos aceptados combinan .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 debe estar dentro del 5 % de 9:16 o 16:9. Si también se proporciona image_reference_url, el video tiene prioridad.

Selección visual de catálogo usada solo cuando no se proporciona ninguna referencia de imagen o video; None y el valor predeterminado la dejan sin establecer. Esta imagen nunca proporciona audio, que siempre procede de audio_url. Para elegir una imagen, previsualiza 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 pública de la imagen de referencia, accesible sin cookies ni encabezados de autorización; proporcionar video_reference_url hace que se ignore. Acepta una sola imagen estática en formato .jpg, .jpeg, .png o .webp, limitada a 25 MiB y 25 megapíxeles. El lado más corto debe medir al menos 512 px y ningún lado 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 cotización → 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 se guarda (localStorage) únicamente si marcas Recordar. Obtener una clave de API

Acerca de Mirage Avatar X

Crea un vídeo de avatar sincronizado con los labios a partir de `audio_url` (3 a 180 segundos). El contenido visual procede de `video_reference_url`, `image_reference_url` o un `avatar` de catálogo; si se proporcionan ambos, la referencia de vídeo tiene prioridad sobre la imagen. La opción de avatar solo proporciona elementos visuales, no audio. Las URL de referencia deben poder consultarse públicamente mediante HTTPS.

Parámetros

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

NombreTipo PredeterminadoPermitido Descripción
audio_urlobligatorio audio
Tipourl · audio
Dirección HTTPS pública del audio que controla el video 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 una sola secuencia 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 pública del video de referencia, accesible sin encabezados de autorización ni cookies, para un archivo que contenga exactamente una secuencia de video y al menos un segmento adecuado de 1 segundo que sirva de referencia; el audio se ignora. Los archivos aceptados combinan .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 debe estar dentro del 5 % de 9:16 o 16:9. Si también se proporciona image_reference_url, el video 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 catálogo usada solo cuando no se proporciona ninguna referencia de imagen o video; None y el valor predeterminado la dejan sin establecer. Esta imagen nunca proporciona audio, que siempre procede de audio_url. Para elegir una imagen, previsualiza 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 pública de la imagen de referencia, accesible sin cookies ni encabezados de autorización; proporcionar video_reference_url hace que se ignore. Acepta una sola imagen estática en formato .jpg, .jpeg, .png o .webp, limitada a 25 MiB y 25 megapíxeles. El lado más corto debe medir al menos 512 px y ningún lado 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 carga. 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 (se cobra 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/developers/models/mirage-api/avatar-x/reference-to-video.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt