Siirry sisältöön

Mirage Avatar X

Integroi

Mallin tunniste 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"

Esimerkin kaltaiset tiedostot: 3,00 $ 3 000 API-krediittiä · ≈ 314,07 ₽ tiedostosi mitataan ennen suorittamista Suorita tällä sivulla

Hanki API-avain
Mirage Huulisynkronointi ja avatarit ViitesyötteetHuulisynkronointi #avatar#lipsync#talking-head

Avatar X -puhuvapäävideo omalla äänellä ja kuva-, video- tai valmisavatar-viitteellä

Mirage · Video

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

•pakollinen audio_url
Pudota tiedosto tai

Generoitua videota ohjaavan äänen julkinen HTTPS-osoite, johon pääsee ilman valtuutusotsakkeita tai evästeitä. Hyväksytyt äänimuodot ovat FLAC, Opus tai Vorbis, AAC tai ALAC, PCM WAV tai AIFF sekä MP3. Tiedoston on sisällettävä yksi mono- tai stereoraita, kestettävä 3–180 sekuntia, oltava enintään 64 MiB ja näytteenottotaajuuden oltava 8–48 kHz.

Lisäasetukset video_reference_url · avatar · image_reference_url

Viitevideon julkisesti käytettävissä oleva HTTPS-URL-osoite ilman valtuutusotsakkeita tai evästeitä. Tiedoston on sisällettävä täsmälleen yksi videoraita ja vähintään yksi sopiva 1 sekunnin segmentti viitteeksi; ääni ohitetaan. Hyväksyttyjä ovat .mp4-, .mov- tai .m4v-tiedostot koodekilla H.264, H.265/HEVC tai ProRes sekä .webm-tiedostot koodekilla VP8 tai VP9. Keston on oltava 1–120 sekuntia, koon enintään 1 GiB ja kuvasuhteen oltava 5 %:n sisällä suhteesta 9:16 tai 16:9. Jos image_reference_url annetaan myös, video on etusijalla.

Varastovisuaali, jota käytetään vain, kun kuva- tai videoviitettä ei anneta; None ja oletus jättävät sen määrittämättä. Tämä visuaali ei koskaan sisällä ääntä, joka tulee aina osoitteesta audio_url. Valitse visuaali esikatselemalla vaihtoehdot [avatar-luettelossa](https://captions.ai/help/docs/api/actor-catalog) ja kopioimalla sen täsmällinen Avatar-arvo.

Viitekuvan HTTPS-URL-osoite, joka on julkisesti käytettävissä ilman evästeitä tai valtuutusotsakkeita; video_reference_url-ohjelman antaminen aiheuttaa sen ohittamisen. Hyväksytty on yksi staattinen kuva muodossa .jpg, .jpeg, .png tai .webp, enintään 25 MiB ja 25 megapikseliä. Lyhyemmän reunan on oltava vähintään 512 px eikä kumpikaan reuna saa ylittää 8192 px; kuvasuhteen on oltava 5 %:n sisällä suhteesta 9:16 tai 16:9.

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

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Mirage Avatar X

Luo huulisynkronoidun avatarvideon `audio_url`-äänestä (3–180 sekuntia). Visuaalinen sisältö tulee `video_reference_url`- tai `image_reference_url`-osoitteesta tai valmiista `avatar`-avatarista; video saa etusijan kuvaan nähden, jos molemmat annetaan. Avatar-vaihtoehto tarjoaa vain visuaalisen sisällön, ei ääntä. Viiteosoitteiden on oltava julkisesti haettavissa HTTPS-yhteydellä.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
audio_urlpakollinen audio
Tyyppiurl · audio
Generoitua videota ohjaavan äänen julkinen HTTPS-osoite, johon pääsee ilman valtuutusotsakkeita tai evästeitä. Hyväksytyt äänimuodot ovat FLAC, Opus tai Vorbis, AAC tai ALAC, PCM WAV tai AIFF sekä MP3. Tiedoston on sisällettävä yksi mono- tai stereoraita, kestettävä 3–180 sekuntia, oltava enintään 64 MiB ja näytteenottotaajuuden oltava 8–48 kHz.
video_reference_urlvalinnainen
Tyyppistring | null
Viitevideon julkisesti käytettävissä oleva HTTPS-URL-osoite ilman valtuutusotsakkeita tai evästeitä. Tiedoston on sisällettävä täsmälleen yksi videoraita ja vähintään yksi sopiva 1 sekunnin segmentti viitteeksi; ääni ohitetaan. Hyväksyttyjä ovat .mp4-, .mov- tai .m4v-tiedostot koodekilla H.264, H.265/HEVC tai ProRes sekä .webm-tiedostot koodekilla VP8 tai VP9. Keston on oltava 1–120 sekuntia, koon enintään 1 GiB ja kuvasuhteen oltava 5 %:n sisällä suhteesta 9:16 tai 16:9. Jos image_reference_url annetaan myös, video on etusijalla.
avatarvalinnainen
Tyyppienum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 lisääNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Varastovisuaali, jota käytetään vain, kun kuva- tai videoviitettä ei anneta; None ja oletus jättävät sen määrittämättä. Tämä visuaali ei koskaan sisällä ääntä, joka tulee aina osoitteesta audio_url. Valitse visuaali esikatselemalla vaihtoehdot [avatar-luettelossa](https://captions.ai/help/docs/api/actor-catalog) ja kopioimalla sen täsmällinen Avatar-arvo.
image_reference_urlvalinnainen
Tyyppistring | null
Viitekuvan HTTPS-URL-osoite, joka on julkisesti käytettävissä ilman evästeitä tai valtuutusotsakkeita; video_reference_url-ohjelman antaminen aiheuttaa sen ohittamisen. Hyväksytty on yksi staattinen kuva muodossa .jpg, .jpeg, .png tai .webp, enintään 25 MiB ja 25 megapikseliä. Lyhyemmän reunan on oltava vähintään 512 px eikä kumpikaan reuna saa ylittää 8192 px; kuvasuhteen on oltava 5 %:n sisällä suhteesta 9:16 tai 16:9.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
video
object {url, content_type, file_name, file_size}

Lisää malleja: Huulisynkronointi ja avatarit

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/mirage-api/avatar-x/reference-to-video.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt