Lumaktaw sa nilalaman

Mirage Avatar X

I-integrate

ID ng 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"

Mga file na katulad ng halimbawa: $3.00 3,000 kredito ng API sinusukat ang iyong mga file bago patakbuhin Patakbuhin ito sa page na ito

Kumuha ng API key
Mirage Lipsync at Avatar Mga reference inputLipsync #avatar#talking-head

Avatar X talking-head video na pinapagana ng iyong audio at larawan, video o stock avatar reference

Mirage · video

Dito mapupunta ang iyong unang resulta

Bumuo ng kahilingan sa ibaba at patakbuhin ito gamit ang iyong API key. Kinokopya ang mga output sa aming storage, na pinananatili nang walang hanggan o 7 araw nang libre.

Bumuo ng kahilingan

Ang mga control ay binubuo mula sa schema ng modelo. Nagbabago ang code at presyo habang ina-adjust mo ang mga ito.

•kinakailangan audio_url
Mag-drop ng file, o

Pampublikong HTTPS address para sa audio na nagpapatakbo sa nabuong video, na maa-access nang walang authorization header o cookie. Ang mga tinatanggap na audio format ay FLAC, Opus o Vorbis, AAC o ALAC, PCM WAV o AIFF, at MP3. Dapat may iisang mono o stereo stream ang file, tumagal nang 3–180 segundo, hindi lumampas sa 64 MiB, at may sample rate na 8–48 kHz.

advanced video_reference_url · avatar · image_reference_url

HTTPS URL ng reference video, pampublikong maa-access nang walang authorization header o cookie, para sa file na may eksaktong isang video stream at kahit isang angkop na 1-segundong segment bilang reference; hindi ginagamit ang audio. Ang mga tinatanggap na file ay .mp4, .mov, o .m4v na may H.264, H.265/HEVC, o ProRes, o .webm na may VP8 o VP9; dapat 1 hanggang 120 segundo ang haba, hindi lalampas sa 1 GiB ang laki, at nasa loob ng 5% ng 9:16 o 16:9 ang display aspect ratio. Kung ibinigay din ang image_reference_url, mananaig ang video.

Pagpili ng stock visual na ginagamit lamang kapag walang ibinigay na reference na larawan o video; parehong iniiwan ng None at default na hindi nakatakda. Hindi kailanman nagmumula sa visual na ito ang audio at palaging mula sa audio_url. Upang pumili ng visual, i-preview ang mga opsyon sa [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) at kopyahin ang eksaktong Avatar value.

HTTPS URL ng reference na larawan, pampublikong maa-access nang walang cookie o authorization header; kapag may video_reference_url, hindi ito papansinin. Tumatanggap ng isang static na larawan sa .jpg, .jpeg, .png, o .webp, hanggang 25 MiB at 25 megapixel. Dapat hindi bababa sa 512 px ang mas maikling gilid at hindi lalampas sa 8192 px ang alinmang gilid; dapat nasa loob ng 5% ng 9:16 o 16:9 ang aspect ratio.

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

Patakbuhin ang kahilingang ito

Nananatili ang iyong key sa browser na ito: ipinapadala lamang ito sa Doitong API at sine-save (localStorage) lamang kung pipiliin mo ang Tandaan. Kumuha ng API key

Tungkol sa Mirage Avatar X

Gumagawa ng lip-synced avatar video mula sa `audio_url` (3 hanggang 180 segundo). Nagmumula ang visual sa `video_reference_url`, `image_reference_url` o stock `avatar`; inuuna ang video reference kaysa larawan kapag parehong ibinigay. Visuals lamang ang ibinibigay ng avatar option, hindi audio. Dapat publicly fetchable sa HTTPS ang reference URLs.

Mga parameter

Ipadala ang canonical na pangalan o ang native na pangalan, hindi pareho. Mga canonical na pangalan

PangalanUri defaultPinapayagan Paglalarawan
audio_urlkinakailangan audio
Uriurl · audio
Pampublikong HTTPS address para sa audio na nagpapatakbo sa nabuong video, na maa-access nang walang authorization header o cookie. Ang mga tinatanggap na audio format ay FLAC, Opus o Vorbis, AAC o ALAC, PCM WAV o AIFF, at MP3. Dapat may iisang mono o stereo stream ang file, tumagal nang 3–180 segundo, hindi lumampas sa 64 MiB, at may sample rate na 8–48 kHz.
video_reference_urlopsyonal
Uristring | null
HTTPS URL ng reference video, pampublikong maa-access nang walang authorization header o cookie, para sa file na may eksaktong isang video stream at kahit isang angkop na 1-segundong segment bilang reference; hindi ginagamit ang audio. Ang mga tinatanggap na file ay .mp4, .mov, o .m4v na may H.264, H.265/HEVC, o ProRes, o .webm na may VP8 o VP9; dapat 1 hanggang 120 segundo ang haba, hindi lalampas sa 1 GiB ang laki, at nasa loob ng 5% ng 9:16 o 16:9 ang display aspect ratio. Kung ibinigay din ang image_reference_url, mananaig ang video.
avataropsyonal
Urienum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 paNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Pagpili ng stock visual na ginagamit lamang kapag walang ibinigay na reference na larawan o video; parehong iniiwan ng None at default na hindi nakatakda. Hindi kailanman nagmumula sa visual na ito ang audio at palaging mula sa audio_url. Upang pumili ng visual, i-preview ang mga opsyon sa [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) at kopyahin ang eksaktong Avatar value.
image_reference_urlopsyonal
Uristring | null
HTTPS URL ng reference na larawan, pampublikong maa-access nang walang cookie o authorization header; kapag may video_reference_url, hindi ito papansinin. Tumatanggap ng isang static na larawan sa .jpg, .jpeg, .png, o .webp, hanggang 25 MiB at 25 megapixel. Dapat hindi bababa sa 512 px ang mas maikling gilid at hindi lalampas sa 8192 px ang alinmang gilid; dapat nasa loob ng 5% ng 9:16 o 16:9 ang aspect ratio.
kinakailangan Canonical na pangalan, tinatanggap din

Tumatanggap ang mga parameter ng file ng pampublikong https:// URL, data: URI na hanggang 10 MB, o file_url ng isang upload. Mga 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"
  }
}
Ikaw ang pumipili para sa iyong mga fileAng bawat outputs[].url ay kopya sa aming storage: pinananatili nang walang hanggan (sinisingil bawat GB-month) o 7 araw nang libre, ayon sa setting ng iyong account o ?storage=.
Parehong shape sa bawat modelotype, url, content_type, width, height at duration, para sa mga larawan, video at audio. Ang output ay sariling result object ng modelo.
Mga field ng output
video
object {url, content_type, file_name, file_size}

Higit pang modelo: Lipsync at Avatar

Para sa mga AI agent: nasa Markdown ang pahinang ito sa https://doitong.com/fil/developers/models/mirage-api/avatar-x/reference-to-video.md. Lahat ng modelo at gabay: https://doitong.com/developers/llms.txt