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

Archivos como el ejemplo: $3.00 3,000 créditos de API · ≈ ₽322.74 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

Video de avatar parlante Avatar X controlado por tu audio y una referencia de imagen, video o avatar de catálogo

Mirage · Video

Tu primer resultado aparecerá aquí

Crea una solicitud abajo y ejecútala con tu clave de API. Las salidas se copian en nuestro almacenamiento, donde se conservan 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 conforme los cambias.

•obligatorio audio_url
Suelta un archivo o

Dirección HTTPS pública del audio que impulsa 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 transmisión mono o estéreo, durar de 3 a 180 segundos, ocupar no más de 64 MiB y tener una frecuencia de muestreo de 8 a 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 transmisión de video y al menos un segmento adecuado de 1 segundo que sirva como 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 de pantalla debe estar dentro de 5% de 9:16 o 16:9. Si también se proporciona image_reference_url, el video tiene prioridad.

Selección visual de archivo de catálogo que se usa únicamente cuando no se proporciona ninguna referencia de imagen o video; None y el valor predeterminado la dejan sin establecer. Este elemento visual nunca proporciona audio, que siempre proviene 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 sola 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 de 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.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"

Ejecutar esta solicitud

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

Acerca de Mirage Avatar X

Crea un video de avatar con sincronización labial a partir de `audio_url` (3 a 180 segundos). El contenido visual proviene de `video_reference_url`, `image_reference_url` o un `avatar` de catálogo; si se proporcionan ambos, la referencia de video 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 impulsa 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 transmisión mono o estéreo, durar de 3 a 180 segundos, ocupar no más de 64 MiB y tener una frecuencia de muestreo de 8 a 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 transmisión de video y al menos un segmento adecuado de 1 segundo que sirva como 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 de pantalla debe estar dentro de 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 archivo de catálogo que se usa únicamente cuando no se proporciona ninguna referencia de imagen o video; None y el valor predeterminado la dejan sin establecer. Este elemento visual nunca proporciona audio, que siempre proviene 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 sola 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 de 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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tus archivos, tú eligesCada outputs[].url es una copia en nuestro almacenamiento: se conserva para siempre (con cobro 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 video 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á disponible en https://doitong.com/es-MX/developers/models/mirage-api/avatar-x/reference-to-video.md. Todos los modelos y guías: https://doitong.com/developers/llms.txt