အကြောင်းအရာသို့ ကျော်ရန်

Mirage Avatar X

ပေါင်းစည်းရန်

မော်ဒယ် 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"

နမူနာကဲ့သို့ ဖိုင်များ: ၃.၀၀ $ ၃,၀၀၀ API ခရက်ဒစ် လုပ်ဆောင်မီ သင့်ဖိုင်များကို တိုင်းတာသည် ဤစာမျက်နှာတွင် လုပ်ဆောင်ရန်

API ကီး ရယူရန်
Mirage Lipsync နှင့် Avatars ရည်ညွှန်း ထည့်သွင်းချက်များLipsync #avatar#talking-head

သင့်အသံနှင့် ပုံ၊ ဗီဒီယို သို့မဟုတ် စတော့ကိုယ်ပွားရုပ်ပုံ ရည်ညွှန်းချက်ဖြင့် မောင်းနှင်သော ကိုယ်ပွားရုပ်ပုံ X စကားပြောမျက်နှာဗီဒီယို

Mirage · ဗီဒီယို

သင့်ပထမဆုံးရလဒ် ဤနေရာတွင် ပေါ်လာမည်

အောက်တွင် တောင်းဆိုချက်တစ်ခု တည်ဆောက်ပြီး သင့် API ကီးဖြင့် လုပ်ဆောင်ပါ။ ထွက်ရလဒ်များကို ကျွန်ုပ်တို့၏ သိုလှောင်မှုသို့ ကူးယူပြီး အမြဲတမ်း သို့မဟုတ် ၇ ရက် အခမဲ့ သိမ်းထားသည်။

တောင်းဆိုမှုတစ်ခု တည်ဆောက်ရန်

ထိန်းချုပ်မှုများကို မော်ဒယ် schema မှ အလိုအလျောက်ဖန်တီးသည်။ ၎င်းတို့ကို ပြောင်းလဲသည်နှင့် code နှင့် စျေးနှုန်းတို့လည်း ပြောင်းလဲမည်။

•လိုအပ်သည် audio_url
ဖိုင်ကို ဆွဲချပါ၊ သို့မဟုတ်

authorization headers သို့မဟုတ် cookies မလိုဘဲ ဝင်ရောက်နိုင်သော၊ ဖန်တီးထားသော ဗီဒီယိုကို မောင်းနှင်မည့် အသံအတွက် အများပြည်သူသုံး HTTPS address။ လက်ခံသည့် အသံ format များမှာ FLAC၊ Opus သို့မဟုတ် Vorbis၊ AAC သို့မဟုတ် ALAC၊ PCM WAV သို့မဟုတ် AIFF နှင့် MP3 တို့ ဖြစ်သည်။ ဖိုင်တွင် mono သို့မဟုတ် stereo stream တစ်ခုတည်း ပါရမည်၊ 3–180 စက္ကန့် ကြာရမည်၊ 64 MiB ထက် မပိုရမည်၊ sample rate သည် 8–48 kHz ဖြစ်ရမည်။

အဆင့်မြင့် video_reference_url · avatar · image_reference_url

authorization headers သို့မဟုတ် cookies မလိုဘဲ အများပြည်သူဝင်ရောက်နိုင်သော ရည်ညွှန်းဗီဒီယို HTTPS URL။ ဖိုင်တွင် ဗီဒီယို stream တစ်ခုတည်းနှင့် ရည်ညွှန်းအဖြစ် အသုံးပြုနိုင်သော 1-စက္ကန့် segment အနည်းဆုံးတစ်ခု ပါရမည်။ အသံကို လျစ်လျူရှုသည်။ လက်ခံသည့် ဖိုင်တွဲဖက်မှုများမှာ H.264၊ H.265/HEVC သို့မဟုတ် ProRes ပါသော .mp4၊ .mov သို့မဟုတ် .m4v၊ သို့မဟုတ် VP8 သို့မဟုတ် VP9 ပါသော .webm ဖြစ်သည်။ ကြာချိန်သည် 1 မှ 120 စက္ကန့်၊ အရွယ်အစားသည် 1 GiB ထက် မပိုရ၊ display aspect ratio သည် 9:16 သို့မဟုတ် 16:9 တစ်ခုခု၏ 5% အတွင်း ဖြစ်ရမည်။ image_reference_url ကိုလည်း ပေးထားပါက ဗီဒီယိုကို ဦးစားပေးသည်။

ပုံ သို့မဟုတ် ဗီဒီယို ရည်ညွှန်းချက် မပေးထားသည့်အခါတွင်သာ အသုံးပြုသည့် stock visual ရွေးချယ်မှု။ None နှင့် မူလတန်ဖိုး နှစ်ခုစလုံးက ၎င်းကို မသတ်မှတ်ထားဘဲ ထားသည်။ ဤ visual မှ အသံကို မည်သည့်အခါမျှ မပေးဘဲ audio_url မှ အမြဲရယူသည်။ visual ရွေးချယ်ရန် [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) တွင် ရွေးချယ်စရာများကို preview ကြည့်ပြီး ၎င်း၏ တိကျသော Avatar တန်ဖိုးကို ကူးယူပါ။

cookies သို့မဟုတ် authorization headers မလိုဘဲ အများပြည်သူဝင်ရောက်နိုင်သော ရည်ညွှန်းပုံ HTTPS URL။ video_reference_url ပေးပါက ၎င်းကို လျစ်လျူရှုသည်။ .jpg၊ .jpeg၊ .png သို့မဟုတ် .webp format ရှိ static ပုံတစ်ပုံကိုသာ လက်ခံပြီး 25 MiB နှင့် 25 မီဂါပစ်ဇယ်အထိ ကန့်သတ်ထားသည်။ အတိုဘက်သည် အနည်းဆုံး 512 px ဖြစ်ရမည်၊ ဘက်နှစ်ဘက်စလုံးသည် 8192 px ထက် မကျော်ရ၊ aspect ratio သည် 9:16 သို့မဟုတ် 16:9 ၏ 5% အတွင်း ဖြစ်ရမည်။

POST /run/mirage-api/avatar-x/reference-to-video?wait=20 ကုန်ကျစရိတ် → ၃.၀၀ $
# 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"

ဤတောင်းဆိုချက်ကို လုပ်ဆောင်ရန်

သင့် key သည် ဤဘရောက်ဇာထဲတွင်သာ ရှိမည်ဖြစ်ပြီး Doitong API သို့သာ ပို့မည်။ Remember ကို အမှန်ခြစ်ထားမှသာ (localStorage) တွင် သိမ်းမည်။ API ကီး ရယူရန်

Mirage Avatar X အကြောင်း

`audio_url` မှ အသံနှုတ်ခမ်းလှုပ်ရှားမှု ထပ်တူပြုထားသော ကိုယ်ပွားရုပ်ပုံဗီဒီယိုကို (3 မှ 180 စက္ကန့်အထိ) ဖန်တီးသည်။ ရုပ်ပုံမြင်ကွင်းကို `video_reference_url`၊ `image_reference_url` သို့မဟုတ် စတော့ `avatar` မှ ရယူသည်။ နှစ်မျိုးစလုံးပေးထားပါက ဗီဒီယိုရည်ညွှန်းချက်သည် ပုံရည်ညွှန်းချက်ထက် ဦးစားပေးသည်။ `avatar` ရွေးချယ်မှုသည် ရုပ်ပုံမြင်ကွင်းကိုသာ ပေးပြီး အသံမပါဝင်ပါ။ ရည်ညွှန်း URL များကို HTTPS ဖြင့် အများပြည်သူက ရယူနိုင်ရမည်။

ပါရာမီတာများ

စံအမည် သို့မဟုတ် မူရင်းအမည် တစ်ခုခုကိုသာ ပို့ပါ၊ နှစ်ခုလုံး မပို့ပါနှင့်။ စံအမည်များ

အမည်အမျိုးအစား မူလတန်ဖိုးခွင့်ပြုထားသည် ဖော်ပြချက်
audio_urlလိုအပ်သည် audio
အမျိုးအစားurl · audio
authorization headers သို့မဟုတ် cookies မလိုဘဲ ဝင်ရောက်နိုင်သော၊ ဖန်တီးထားသော ဗီဒီယိုကို မောင်းနှင်မည့် အသံအတွက် အများပြည်သူသုံး HTTPS address။ လက်ခံသည့် အသံ format များမှာ FLAC၊ Opus သို့မဟုတ် Vorbis၊ AAC သို့မဟုတ် ALAC၊ PCM WAV သို့မဟုတ် AIFF နှင့် MP3 တို့ ဖြစ်သည်။ ဖိုင်တွင် mono သို့မဟုတ် stereo stream တစ်ခုတည်း ပါရမည်၊ 3–180 စက္ကန့် ကြာရမည်၊ 64 MiB ထက် မပိုရမည်၊ sample rate သည် 8–48 kHz ဖြစ်ရမည်။
video_reference_urlရွေးချယ်နိုင်သည်
အမျိုးအစားstring | null
authorization headers သို့မဟုတ် cookies မလိုဘဲ အများပြည်သူဝင်ရောက်နိုင်သော ရည်ညွှန်းဗီဒီယို HTTPS URL။ ဖိုင်တွင် ဗီဒီယို stream တစ်ခုတည်းနှင့် ရည်ညွှန်းအဖြစ် အသုံးပြုနိုင်သော 1-စက္ကန့် segment အနည်းဆုံးတစ်ခု ပါရမည်။ အသံကို လျစ်လျူရှုသည်။ လက်ခံသည့် ဖိုင်တွဲဖက်မှုများမှာ H.264၊ H.265/HEVC သို့မဟုတ် ProRes ပါသော .mp4၊ .mov သို့မဟုတ် .m4v၊ သို့မဟုတ် VP8 သို့မဟုတ် VP9 ပါသော .webm ဖြစ်သည်။ ကြာချိန်သည် 1 မှ 120 စက္ကန့်၊ အရွယ်အစားသည် 1 GiB ထက် မပိုရ၊ display aspect ratio သည် 9:16 သို့မဟုတ် 16:9 တစ်ခုခု၏ 5% အတွင်း ဖြစ်ရမည်။ image_reference_url ကိုလည်း ပေးထားပါက ဗီဒီယိုကို ဦးစားပေးသည်။
avatarရွေးချယ်နိုင်သည်
အမျိုးအစားenum
NoneAyeshaAyesha (16:9)FarhanFarhan (16:9)GiuliaGiulia (16:9)JasmineJasmine (16:9)LukeLuke (16:9)MayaMaya (16:9)MichaelMichael (16:9)Neha
+5 ခု ထပ်မံNeha (16:9)TariqTariq (16:9)ValerieValerie (16:9)
ပုံ သို့မဟုတ် ဗီဒီယို ရည်ညွှန်းချက် မပေးထားသည့်အခါတွင်သာ အသုံးပြုသည့် stock visual ရွေးချယ်မှု။ None နှင့် မူလတန်ဖိုး နှစ်ခုစလုံးက ၎င်းကို မသတ်မှတ်ထားဘဲ ထားသည်။ ဤ visual မှ အသံကို မည်သည့်အခါမျှ မပေးဘဲ audio_url မှ အမြဲရယူသည်။ visual ရွေးချယ်ရန် [avatar catalog](https://captions.ai/help/docs/api/actor-catalog) တွင် ရွေးချယ်စရာများကို preview ကြည့်ပြီး ၎င်း၏ တိကျသော Avatar တန်ဖိုးကို ကူးယူပါ။
image_reference_urlရွေးချယ်နိုင်သည်
အမျိုးအစားstring | null
cookies သို့မဟုတ် authorization headers မလိုဘဲ အများပြည်သူဝင်ရောက်နိုင်သော ရည်ညွှန်းပုံ HTTPS URL။ video_reference_url ပေးပါက ၎င်းကို လျစ်လျူရှုသည်။ .jpg၊ .jpeg၊ .png သို့မဟုတ် .webp format ရှိ static ပုံတစ်ပုံကိုသာ လက်ခံပြီး 25 MiB နှင့် 25 မီဂါပစ်ဇယ်အထိ ကန့်သတ်ထားသည်။ အတိုဘက်သည် အနည်းဆုံး 512 px ဖြစ်ရမည်၊ ဘက်နှစ်ဘက်စလုံးသည် 8192 px ထက် မကျော်ရ၊ aspect ratio သည် 9:16 သို့မဟုတ် 16:9 ၏ 5% အတွင်း ဖြစ်ရမည်။
လိုအပ်သည် စံအမည်၊ ထို့အပြင် လက်ခံသည်

ဖိုင်ပါရာမီတာများသည် အများပြည်သူသုံး https:// URL၊ 10 MB အထိ data: URI သို့မဟုတ် အပ်လုဒ်လုပ်ထားသောဖိုင်၏ file_url ကို လက်ခံသည်။ ဖိုင်များ

ထွက်ရလဒ်

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"
  }
}
သင့်ဖိုင်များ၊ သင့်ရွေးချယ်မှုoutputs[].url တိုင်းသည် ကျွန်ုပ်တို့၏ သိုလှောင်မှုရှိ မိတ္တူဖြစ်သည်- အမြဲတမ်း (GB-month အလိုက် ငွေပေးရသည်) သို့မဟုတ် ၇ ရက် အခမဲ့၊ သင့်အကောင့်ဆက်တင် သို့မဟုတ် ?storage= ဖြင့် သိမ်းထားသည်။
မော်ဒယ်တိုင်းတွင် ပုံစံတူပုံ၊ ဗီဒီယိုနှင့် အသံတို့အတွက် type၊ url၊ content_type၊ width၊ height နှင့် duration။ output သည် မော်ဒယ်ကိုယ်တိုင်၏ ရလဒ် object ဖြစ်သည်။
ထွက်ရလဒ်၏ Fields များ
video
object {url, content_type, file_name, file_size}

နောက်ထပ် မော်ဒယ်များ: Lipsync နှင့် Avatars

AI အေးဂျင့်များအတွက်- ဤစာမျက်နှာ၏ Markdown ကို ဤနေရာတွင် ရရှိနိုင်သည် https://doitong.com/my/developers/models/mirage-api/avatar-x/reference-to-video.md. မော်ဒယ်များနှင့် လမ်းညွှန်များအားလုံး: https://doitong.com/developers/llms.txt