Vai al contenuto

Mirage Avatar X

Integra

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

File come nell'esempio: 3,00 $ 3000 crediti API i tuoi file vengono misurati prima dell'esecuzione Esegui in questa pagina

Ottieni la chiave API
Mirage Lipsync e avatar Input di riferimentoLipsync #avatar#talking-head

Video avatar parlante Avatar X guidato dal tuo audio e da un'immagine, un video o un avatar stock di riferimento

Mirage · Video

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio audio_url
Trascina un file oppure

Indirizzo HTTPS pubblico dell'audio che guida il video generato, accessibile senza header di autorizzazione o cookie. I formati audio accettati sono FLAC, Opus o Vorbis, AAC o ALAC, PCM WAV o AIFF e MP3. Il file deve contenere un solo stream mono o stereo, durare 3–180 secondi, occupare non più di 64 MiB e avere una frequenza di campionamento di 8–48 kHz.

Avanzate video_reference_url · avatar · image_reference_url

URL HTTPS del video di riferimento, accessibile pubblicamente senza header di autorizzazione o cookie, per un file contenente esattamente un video stream e almeno un segmento adatto di 1 secondo da usare come riferimento; l'audio viene ignorato. I file accettati sono .mp4, .mov o .m4v con H.264, H.265/HEVC o ProRes, oppure .webm con VP8 o VP9; la durata deve essere da 1 a 120 secondi, la dimensione non deve superare 1 GiB e il rapporto d'aspetto deve rientrare entro il 5% di 9:16 o 16:9. Se viene fornito anche image_reference_url, il video ha la precedenza.

Selezione visiva stock usata solo quando non viene fornito alcun riferimento immagine o video; None e il valore predefinito la lasciano non impostata. L'audio non viene mai fornito da questo elemento visivo e proviene sempre da audio_url. Per scegliere un elemento visivo, visualizzare in anteprima le opzioni nel [catalogo degli avatar](https://captions.ai/help/docs/api/actor-catalog) e copiare il valore Avatar esatto.

URL HTTPS dell'immagine di riferimento, accessibile pubblicamente senza cookie o header di autorizzazione; fornire video_reference_url ne causa l'ignoramento. Accetta una singola immagine statica in formato .jpg, .jpeg, .png o .webp, con limite di 25 MiB e 25 megapixel. Il lato più corto deve misurare almeno 512 px e nessun lato può superare 8192 px; il rapporto d'aspetto deve rientrare entro il 5% di 9:16 o 16:9.

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

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Mirage Avatar X

Crea un video avatar sincronizzato con le labbra da `audio_url` (da 3 a 180 secondi). La parte visiva proviene da `video_reference_url`, `image_reference_url` o da un `avatar` stock; se sono presenti entrambi, il riferimento video ha la precedenza sull'immagine. L'opzione avatar fornisce solo elementi visivi, non audio. Gli URL di riferimento devono essere accessibili pubblicamente tramite HTTPS.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
audio_urlobbligatorio audio
Tipourl · audio
Indirizzo HTTPS pubblico dell'audio che guida il video generato, accessibile senza header di autorizzazione o cookie. I formati audio accettati sono FLAC, Opus o Vorbis, AAC o ALAC, PCM WAV o AIFF e MP3. Il file deve contenere un solo stream mono o stereo, durare 3–180 secondi, occupare non più di 64 MiB e avere una frequenza di campionamento di 8–48 kHz.
video_reference_urlfacoltativo
Tipostring | null
URL HTTPS del video di riferimento, accessibile pubblicamente senza header di autorizzazione o cookie, per un file contenente esattamente un video stream e almeno un segmento adatto di 1 secondo da usare come riferimento; l'audio viene ignorato. I file accettati sono .mp4, .mov o .m4v con H.264, H.265/HEVC o ProRes, oppure .webm con VP8 o VP9; la durata deve essere da 1 a 120 secondi, la dimensione non deve superare 1 GiB e il rapporto d'aspetto deve rientrare entro il 5% di 9:16 o 16:9. Se viene fornito anche image_reference_url, il video ha la precedenza.
avatarfacoltativo
Tipoenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 altriNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Selezione visiva stock usata solo quando non viene fornito alcun riferimento immagine o video; None e il valore predefinito la lasciano non impostata. L'audio non viene mai fornito da questo elemento visivo e proviene sempre da audio_url. Per scegliere un elemento visivo, visualizzare in anteprima le opzioni nel [catalogo degli avatar](https://captions.ai/help/docs/api/actor-catalog) e copiare il valore Avatar esatto.
image_reference_urlfacoltativo
Tipostring | null
URL HTTPS dell'immagine di riferimento, accessibile pubblicamente senza cookie o header di autorizzazione; fornire video_reference_url ne causa l'ignoramento. Accetta una singola immagine statica in formato .jpg, .jpeg, .png o .webp, con limite di 25 MiB e 25 megapixel. Il lato più corto deve misurare almeno 512 px e nessun lato può superare 8192 px; il rapporto d'aspetto deve rientrare entro il 5% di 9:16 o 16:9.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

Output

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
video
object {url, content_type, file_name, file_size}

Altri modelli: Lipsync e avatar

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/mirage-api/avatar-x/reference-to-video.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt