Leum chun t-susbaint

Mirage Avatar X

Amalaich

ID a’ mhodail 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"

Faidhlichean mar an eisimpleir: $3.00 3,000 creideasan API thèid na faidhlichean agad a thomhas ron ruith Ruith e air an duilleig seo

Faigh iuchair API
Mirage Sioncronadh bilean & Ava­taran In-chuir iomraidhSioncronadh bilean #avatar#lipsync#talking-head

Bhidio avatar labhairt Avatar X air a stiùireadh le d’ fhuaim agus iomradh avatar ìomhaigh, bhidio no stòrais

Mirage · Bhidio

Thèid a’ chiad toradh agad an-seo

Tog iarrtas gu h-ìosal agus ruith e leis an iuchair API agad. Tha na h-às-churan air an lethbhreacadh dhan stòradh againn, air an cumail gu bràth no 7 latha an-asgaidh.

Tog iarrtas

Tha na smachdan air an cruthachadh bho sgeama a’ mhodail. Bidh an còd agus a’ phrìs ag ùrachadh fhad ’s a dh’atharraicheas tu iad.

•riatanach audio_url
Leig às faidhle, no

Seòladh poblach HTTPS airson na claisneachd a bhios a’ stiùireadh a’ bhidio a chaidh a ghineadh, ruigsinneach gun chinn ùghdarachaidh no briosgaidean. Is iad na cruthan claisneachd ris an gabhar FLAC, Opus no Vorbis, AAC no ALAC, PCM WAV no AIFF, agus MP3. Feumaidh aon sruth mono no stereo a bhith san fhaidhle, mairsinn 3–180 diogan, gun a bhith nas motha na 64 MiB, agus ìre sampall 8–48 kHz a bhith aige.

Adhartach video_reference_url · avatar · image_reference_url

URL HTTPS bhidio-iomraidh, ruigsinneach gu poblach gun chinn ùghdarachaidh no briosgaidean, airson faidhle anns a bheil dìreach aon sruth bhidio agus co-dhiù aon earrann iomchaidh de 1-diog airson iomradh; cha tèid claisneachd a chleachdadh. Gabhar ri .mp4, .mov, no .m4v le H.264, H.265/HEVC, no ProRes, no .webm le VP8 no VP9; feumaidh an ùine a bhith 1 gu 120 diogan, chan fhaod am meud a bhith nas motha na 1 GiB, agus feumaidh co-mheas taobh an taisbeanaidh a bhith taobh a-staigh 5% de 9:16 no 16:9. Ma thèid image_reference_url a thoirt seachad cuideachd, bidh prìomhachas aig a’ bhidio.

Taghadh lèirsinneach stoc a thèid a chleachdadh dìreach nuair nach eil iomradh ìomhaigh no bhidio air a thoirt seachad; fàgaidh None agus am bun-roghainn e gun shuidheachadh. Cha tèid claisneachd a thoirt seachad leis an lèirsinneach seo agus thig i an-còmhnaidh bho audio_url. Gus lèirsinneach a thaghadh, ro-sheall na roghainnean ann an [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) agus dèan lethbhreac den luach Avatar cheart.

URL HTTPS ìomhaigh-iomraidh, ruigsinneach gu poblach gun briosgaidean no cinn ùghdarachaidh; ma thèid video_reference_url a thoirt seachad, cha tèid a chleachdadh. Gabhar ri aon ìomhaigh statach ann an cruth .jpg, .jpeg, .png, no .webp, cuibhrichte ri 25 MiB agus 25 megapixel. Feumaidh an oir as giorra a bhith co-dhiù 512 px agus chan fhaod oir sam bith a bhith nas motha na 8192 px; feumaidh an co-mheas taobh a bhith taobh a-staigh 5% de 9:16 no 16:9.

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

Ruith an t-iarrtas seo

Fuirichidh an iuchair agad sa bhrobhsair seo: thèid a cur chun Doitong API a-mhàin agus a sàbhaladh (localStorage) a-mhàin ma chuireas tu comharra ri Cuimhnich. Faigh iuchair API

Mu Mirage Avatar X

A’ dèanamh bhidio avatar le gluasad bhilean co-shioncronaichte bho `audio_url` (3 gu 180 diogan). Tha an sealladh a’ tighinn bho `video_reference_url`, `image_reference_url`, no `avatar` stòrais; tha iomradh bhidio a’ faighinn prìomhachas air ìomhaigh nuair a tha an dà chuid air an toirt seachad. Chan eil roghainn an avatar a’ solar ach seallaidhean, chan e fuaim. Feumaidh URLan iomraidh a bhith rim faighinn gu poblach tro HTTPS.

Paramadairean

Cuir an t-ainm canonical no an t-ainm dùthchasach, chan e an dà chuid. Ainmean canonical

AinmSeòrsa Bun-roghainnCeadaichte Tuairisgeul
audio_urlriatanach audio
Seòrsaurl · audio
Seòladh poblach HTTPS airson na claisneachd a bhios a’ stiùireadh a’ bhidio a chaidh a ghineadh, ruigsinneach gun chinn ùghdarachaidh no briosgaidean. Is iad na cruthan claisneachd ris an gabhar FLAC, Opus no Vorbis, AAC no ALAC, PCM WAV no AIFF, agus MP3. Feumaidh aon sruth mono no stereo a bhith san fhaidhle, mairsinn 3–180 diogan, gun a bhith nas motha na 64 MiB, agus ìre sampall 8–48 kHz a bhith aige.
video_reference_urlroghainneil
Seòrsastring | null
URL HTTPS bhidio-iomraidh, ruigsinneach gu poblach gun chinn ùghdarachaidh no briosgaidean, airson faidhle anns a bheil dìreach aon sruth bhidio agus co-dhiù aon earrann iomchaidh de 1-diog airson iomradh; cha tèid claisneachd a chleachdadh. Gabhar ri .mp4, .mov, no .m4v le H.264, H.265/HEVC, no ProRes, no .webm le VP8 no VP9; feumaidh an ùine a bhith 1 gu 120 diogan, chan fhaod am meud a bhith nas motha na 1 GiB, agus feumaidh co-mheas taobh an taisbeanaidh a bhith taobh a-staigh 5% de 9:16 no 16:9. Ma thèid image_reference_url a thoirt seachad cuideachd, bidh prìomhachas aig a’ bhidio.
avatarroghainneil
Seòrsaenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 eileNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
Taghadh lèirsinneach stoc a thèid a chleachdadh dìreach nuair nach eil iomradh ìomhaigh no bhidio air a thoirt seachad; fàgaidh None agus am bun-roghainn e gun shuidheachadh. Cha tèid claisneachd a thoirt seachad leis an lèirsinneach seo agus thig i an-còmhnaidh bho audio_url. Gus lèirsinneach a thaghadh, ro-sheall na roghainnean ann an [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) agus dèan lethbhreac den luach Avatar cheart.
image_reference_urlroghainneil
Seòrsastring | null
URL HTTPS ìomhaigh-iomraidh, ruigsinneach gu poblach gun briosgaidean no cinn ùghdarachaidh; ma thèid video_reference_url a thoirt seachad, cha tèid a chleachdadh. Gabhar ri aon ìomhaigh statach ann an cruth .jpg, .jpeg, .png, no .webp, cuibhrichte ri 25 MiB agus 25 megapixel. Feumaidh an oir as giorra a bhith co-dhiù 512 px agus chan fhaod oir sam bith a bhith nas motha na 8192 px; feumaidh an co-mheas taobh a bhith taobh a-staigh 5% de 9:16 no 16:9.
riatanach Ainm canonical, gabhar ris cuideachd

Gabhaidh paramadairean faidhle ri URL poblach https://, URI data: suas ri 10 MB, no file_url de luchdachadh suas. Faidhlichean

Toradh

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"
  }
}
Na faidhlichean agad, do roghainnTha gach outputs[].url na lethbhreac air an stòradh againn: air a chumail gu bràth (air a phàigheadh gach GB-mìos) no 7 latha an-asgaidh, a rèir suidheachadh a’ chunntais agad no ?storage=.
An aon chruth air gach modailtype, url, content_type, width, height agus duration, airson dealbhan, bhidio agus fuaim le chèile. ’S e output nì toraidh a’ mhodail fhèin.
Raointean toraidh
video
object {url, content_type, file_name, file_size}

Barrachd mhodalan: Sioncronadh bilean & Ava­taran

Do riochdairean AI: tha an duilleag seo mar Markdown aig https://doitong.com/gd/developers/models/mirage-api/avatar-x/reference-to-video.md. Na modailean agus na treòraichean uile: https://doitong.com/developers/llms.txt