Léim chuig an ábhar

Mirage Avatar X

Comhtháthú

Aitheantas na samhla 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"

Comhaid cosúil leis an sampla: $3.00 3,000 gcreidmheas API déantar do chuid comhad a thomhas roimh an rith Rith ar an leathanach seo

Faigh eochair API
Mirage Sioncronú Liopaí agus Abhatáir Ionchuir tagarthaSioncronú liopaí #avatar#lipsync#talking-head

Físeán ceann cainte abhatár X á thiomáint ag do chuid fuaime agus tagairt abhatár íomhá, físeáin nó stoic

Mirage · Físeán

Beidh do chéad toradh anseo

Tóg iarratas thíos agus rith é le d’eochair API. Cóipeáiltear na haschuir chuig ár stóráil, coinnithe go deo nó ar feadh 7 lá saor in aisce.

Tóg iarratas

Gintear na rialtáin ó scéim na samhla. Nuashonraítear an cód agus an praghas de réir mar a athraíonn tú iad.

•riachtanach audio_url
Scaoil comhad, nó

Seoladh poiblí HTTPS don fhuaim a thiomáineann an físeán ginte, inrochtana gan ceanntásca údaraithe ná fianáin. Is iad na formáidí fuaime inghlactha FLAC, Opus nó Vorbis, AAC nó ALAC, PCM WAV nó AIFF, agus MP3. Ní mór sruth aonair mona nó steirió a bheith sa chomhad, mairfidh sé 3–180 soicind, ní bheidh sé níos mó ná 64 MiB, agus beidh ráta samplála 8–48 kHz aige.

Ardleibhéal video_reference_url · avatar · image_reference_url

URL HTTPS físeáin thagartha, inrochtana go poiblí gan ceanntásca údaraithe ná fianáin, do chomhad ina bhfuil sruth físeáin amháin go beacht agus mír oiriúnach 1 soicind ar a laghad le húsáid mar thagairt; déantar neamhaird den fhuaim. Glactar le .mp4, .mov, nó .m4v le H.264, H.265/HEVC, nó ProRes, nó .webm le VP8 nó VP9; caithfidh an fad a bheith 1 go 120 soicind, ní fhéadfaidh an méid dul thar 1 GiB, agus caithfidh an cóimheas gné taispeána a bheith laistigh de 5% de 9:16 nó 16:9. Má sholáthraítear image_reference_url freisin, bíonn tosaíocht ag an bhfíseán.

Roghnú amhairc stoic a úsáidtear nuair nach soláthraítear aon íomhá ná físeán tagartha; fágann None agus an réamhshocrú araon gan socrú é. Ní sholáthraítear fuaim riamh leis an amharc seo agus tagann sí i gcónaí ó audio_url. Chun amharc a roghnú, réamhamharc ar na roghanna sa [chatalóg avatar](https://captions.ai/help/docs/api/actor-catalog) agus cóipeáil a luach cruinn Avatar.

URL HTTPS íomhá tagartha, inrochtana go poiblí gan fianáin ná ceanntásca údaraithe; má sholáthraítear video_reference_url déantar neamhaird de. Glactar le híomhá statach aonair i bhformáid .jpg, .jpeg, .png, nó .webp, teoranta do 25 MiB agus 25 meigiphicteilín. Caithfidh an t-imeall is giorra a bheith 512 px ar a laghad agus ní fhéadfaidh ceachtar imeall dul thar 8192 px; caithfidh an cóimheas gné a bheith laistigh de 5% de 9:16 nó 16:9.

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

Rith an t-iarratas seo

Fanann d'eochair sa bhrabhsálaí seo: seoltar chuig Doitong API amháin í agus sábháiltear (localStorage) í ach amháin má chuireann tú tic le Meabhraigh. Faigh eochair API

Maidir le Mirage Avatar X

Cruthaíonn sé físeán abhatáir sioncronaithe liopaí ó `audio_url` (3 go 180 soicind). Tagann an radharc ó `video_reference_url`, `image_reference_url` nó `avatar` stoic; bíonn tosaíocht ag tagairt an fhíseáin ar an íomhá nuair a thugtar an dá cheann. Soláthraíonn rogha an abhatáir radharc amháin, ní fuaim. Ní mór URLanna tagartha a bheith inrochtana go poiblí thar HTTPS.

Paraiméadair

Seol an t-ainm canónach nó an t-ainm dúchasach, ní an dá cheann. Ainmneacha canónacha

AinmCineál RéamhshocrúCeadaithe Cur síos
audio_urlriachtanach audio
Cineálurl · audio
Seoladh poiblí HTTPS don fhuaim a thiomáineann an físeán ginte, inrochtana gan ceanntásca údaraithe ná fianáin. Is iad na formáidí fuaime inghlactha FLAC, Opus nó Vorbis, AAC nó ALAC, PCM WAV nó AIFF, agus MP3. Ní mór sruth aonair mona nó steirió a bheith sa chomhad, mairfidh sé 3–180 soicind, ní bheidh sé níos mó ná 64 MiB, agus beidh ráta samplála 8–48 kHz aige.
video_reference_urlroghnach
Cineálstring | null
URL HTTPS físeáin thagartha, inrochtana go poiblí gan ceanntásca údaraithe ná fianáin, do chomhad ina bhfuil sruth físeáin amháin go beacht agus mír oiriúnach 1 soicind ar a laghad le húsáid mar thagairt; déantar neamhaird den fhuaim. Glactar le .mp4, .mov, nó .m4v le H.264, H.265/HEVC, nó ProRes, nó .webm le VP8 nó VP9; caithfidh an fad a bheith 1 go 120 soicind, ní fhéadfaidh an méid dul thar 1 GiB, agus caithfidh an cóimheas gné taispeána a bheith laistigh de 5% de 9:16 nó 16:9. Má sholáthraítear image_reference_url freisin, bíonn tosaíocht ag an bhfíseán.
avatarroghnach
Cineálenum
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)
Roghnú amhairc stoic a úsáidtear nuair nach soláthraítear aon íomhá ná físeán tagartha; fágann None agus an réamhshocrú araon gan socrú é. Ní sholáthraítear fuaim riamh leis an amharc seo agus tagann sí i gcónaí ó audio_url. Chun amharc a roghnú, réamhamharc ar na roghanna sa [chatalóg avatar](https://captions.ai/help/docs/api/actor-catalog) agus cóipeáil a luach cruinn Avatar.
image_reference_urlroghnach
Cineálstring | null
URL HTTPS íomhá tagartha, inrochtana go poiblí gan fianáin ná ceanntásca údaraithe; má sholáthraítear video_reference_url déantar neamhaird de. Glactar le híomhá statach aonair i bhformáid .jpg, .jpeg, .png, nó .webp, teoranta do 25 MiB agus 25 meigiphicteilín. Caithfidh an t-imeall is giorra a bheith 512 px ar a laghad agus ní fhéadfaidh ceachtar imeall dul thar 8192 px; caithfidh an cóimheas gné a bheith laistigh de 5% de 9:16 nó 16:9.
riachtanach Ainm canónach, glactar leis freisin

Glacann paraiméadair chomhaid le URL poiblí https://, URI data: suas le 10 MB, nó file_url uaslódála. Comhaid

Aschur

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"
  }
}
Do chuid comhad, do roghaIs cóip ar ár stóráil é gach outputs[].url: coinnithe go deo (íoctha in aghaidh GB-mhí) nó ar feadh 7 lá saor in aisce, de réir shocrú do chuntais nó ?storage=.
An cruth céanna ar gach samhailtype, url, content_type, width, height agus duration, d'íomhánna, d'fhíseáin agus d'fhuaim araon. Is é output réad toraidh na samhla féin.
Réimsí aschuir
video
object {url, content_type, file_name, file_size}

Tuilleadh samhlacha: Sioncronú Liopaí agus Abhatáir

Do ghníomhairí AI: tá an leathanach seo mar Markdown ag https://doitong.com/ga/developers/models/mirage-api/avatar-x/reference-to-video.md. Gach samhail agus treoir: https://doitong.com/developers/llms.txt