Pereiti prie turinio

Mirage Avatar X

Integruoti

Modelio id 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"

Failai kaip pavyzdyje: 3,00 $ 3 000 API kreditų jūsų failai išmatuojami prieš paleidimą Paleisti šiame puslapyje

Gauti API raktą
Mirage Lūpų sinchronizavimas ir avatarai Nuorodų įvestysLūpų sinchronizavimas #avatar#lipsync#talking-head

Avataras X kalbančios galvos vaizdo įrašas, valdomas jūsų garsu ir vaizdo, vaizdo įrašo arba atsarginio avataro pavyzdžiu

Mirage · Vaizdo įrašas

Čia bus pirmasis jūsų rezultatas

Sukurkite užklausą toliau ir paleiskite ją naudodami savo API raktą. Išvestys nukopijuojamos į mūsų saugyklą ir saugomos neribotą laiką arba 7 dienos nemokamai.

Sukurti užklausą

Valdikliai sugeneruojami pagal modelio schemą. Keisdami juos atnaujinsite kodą ir kainą.

•privaloma audio_url
Įmeskite failą arba

Viešai pasiekiamas HTTPS adresas garso, pagal kurį generuojamas vaizdo įrašas; prieigai nereikia autorizacijos antraščių ar slapukų. Priimami garso formatai: FLAC, Opus arba Vorbis, AAC arba ALAC, PCM WAV arba AIFF ir MP3. Faile turi būti vienas mono arba stereo srautas, trukti 3–180 sekundžių, užimti ne daugiau kaip 64 MiB, o diskretizavimo dažnis turi būti 8–48 kHz.

Išplėstiniai video_reference_url · avatar · image_reference_url

Viešai pasiekiama pamatinio vaizdo įrašo HTTPS nuoroda be autorizacijos antraščių ar slapukų. Failas turi turėti tiksliai vieną vaizdo srautą ir bent vieną tinkamą 1 sekundės segmentą, naudojamą kaip pavyzdys; garsas ignoruojamas. Priimamos poros: .mp4, .mov arba .m4v su H.264, H.265/HEVC arba ProRes, taip pat .webm su VP8 arba VP9; trukmė turi būti nuo 1 iki 120 sekundžių, dydis – ne didesnis kaip 1 GiB, o vaizdo formatas turi skirtis ne daugiau kaip 5 % nuo 9:16 arba 16:9. Jei pateiktas ir image_reference_url, pirmenybė teikiama vaizdo įrašui.

Atsarginis vaizdinis pasirinkimas, naudojamas tik nepateikus vaizdo ar vaizdo įrašo pamatinės nuorodos; None ir numatytoji reikšmė palieka jį nenustatytą. Šis vaizdinis elementas niekada nepateikia garso – jis visada gaunamas iš audio_url. Norėdami pasirinkti vaizdinį elementą, peržiūrėkite parinktis [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) ir nukopijuokite tikslią Avatar reikšmę.

Pamatinio vaizdo HTTPS nuoroda, viešai pasiekiama be slapukų ar autorizacijos antraščių; pateikus video_reference_url ji ignoruojama. Priimamas vienas statinis .jpg, .jpeg, .png arba .webp formato vaizdas, ne didesnis kaip 25 MiB ir 25 megapikseliai. Trumpesnė kraštinė turi būti bent 512 px, nė viena kraštinė negali viršyti 8192 px, o vaizdo formatas turi skirtis ne daugiau kaip 5 % nuo 9:16 arba 16:9.

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

Vykdyti šią užklausą

Jūsų raktas lieka šioje naršyklėje: jis siunčiamas tik į Doitong API ir išsaugomas (localStorage) tik pažymėjus Prisiminti. Gauti API raktą

Apie Mirage Avatar X

Sukuria su lūpų judesiais sinchronizuotą avataro vaizdo įrašą iš `audio_url` (3–180 sekundžių). Vaizdas gaunamas iš `video_reference_url`, `image_reference_url` arba atsarginio `avatar`; pateikus abu, vaizdo įrašo etalonas turi pirmenybę prieš vaizdą. Avataro parinktis pateikia tik vaizdą, ne garsą. Etaloniniai URL turi būti viešai pasiekiami per HTTPS.

Parametrai

Siųskite arba kanoninį, arba savąjį pavadinimą, bet ne abu. Kanoniniai pavadinimai

PavadinimasTipas Numatytoji reikšmėLeidžiama Aprašas
audio_urlprivaloma audio
Tipasurl · audio
Viešai pasiekiamas HTTPS adresas garso, pagal kurį generuojamas vaizdo įrašas; prieigai nereikia autorizacijos antraščių ar slapukų. Priimami garso formatai: FLAC, Opus arba Vorbis, AAC arba ALAC, PCM WAV arba AIFF ir MP3. Faile turi būti vienas mono arba stereo srautas, trukti 3–180 sekundžių, užimti ne daugiau kaip 64 MiB, o diskretizavimo dažnis turi būti 8–48 kHz.
video_reference_urlneprivalomas
Tipasstring | null
Viešai pasiekiama pamatinio vaizdo įrašo HTTPS nuoroda be autorizacijos antraščių ar slapukų. Failas turi turėti tiksliai vieną vaizdo srautą ir bent vieną tinkamą 1 sekundės segmentą, naudojamą kaip pavyzdys; garsas ignoruojamas. Priimamos poros: .mp4, .mov arba .m4v su H.264, H.265/HEVC arba ProRes, taip pat .webm su VP8 arba VP9; trukmė turi būti nuo 1 iki 120 sekundžių, dydis – ne didesnis kaip 1 GiB, o vaizdo formatas turi skirtis ne daugiau kaip 5 % nuo 9:16 arba 16:9. Jei pateiktas ir image_reference_url, pirmenybė teikiama vaizdo įrašui.
avatarneprivalomas
Tipasenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
dar +5Neha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Atsarginis vaizdinis pasirinkimas, naudojamas tik nepateikus vaizdo ar vaizdo įrašo pamatinės nuorodos; None ir numatytoji reikšmė palieka jį nenustatytą. Šis vaizdinis elementas niekada nepateikia garso – jis visada gaunamas iš audio_url. Norėdami pasirinkti vaizdinį elementą, peržiūrėkite parinktis [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) ir nukopijuokite tikslią Avatar reikšmę.
image_reference_urlneprivalomas
Tipasstring | null
Pamatinio vaizdo HTTPS nuoroda, viešai pasiekiama be slapukų ar autorizacijos antraščių; pateikus video_reference_url ji ignoruojama. Priimamas vienas statinis .jpg, .jpeg, .png arba .webp formato vaizdas, ne didesnis kaip 25 MiB ir 25 megapikseliai. Trumpesnė kraštinė turi būti bent 512 px, nė viena kraštinė negali viršyti 8192 px, o vaizdo formatas turi skirtis ne daugiau kaip 5 % nuo 9:16 arba 16:9.
privaloma Kanoninis pavadinimas, taip pat priimamas

Failų parametrams reikia viešo https:// URL, ne didesnio nei 10 MB data: URI arba įkelto failo file_url. Failai

Išvestis

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"
  }
}
Jūsų failai — jūsų pasirinkimasKiekvienas outputs[].url yra kopija mūsų saugykloje: saugoma neribotą laiką (mokama už GB per mėnesį) arba 7 dienos nemokamai, pagal paskyros nustatymą arba ?storage=.
Ta pati struktūra kiekviename modelyjetype, url, content_type, width, height ir duration taikomi vaizdams, vaizdo įrašams ir garsui. output yra paties modelio rezultatų objektas.
Išvesties laukai
video
object {url, content_type, file_name, file_size}

Daugiau modelių: Lūpų sinchronizavimas ir avatarai

AI agentams: šis puslapis Markdown formatu pateikiamas adresu https://doitong.com/lt/developers/models/mirage-api/avatar-x/reference-to-video.md. Visi modeliai ir vadovai: https://doitong.com/developers/llms.txt