ဘာသာပြန် API
သင့်စာရွက်စာတမ်းများကို စခရစ်ဖြင့် Edgepedia ဘာသာပြန် ဝန်ဆောင်မှုသို့ ပို့ကာ ဘာသာပြန်စာများ ပြန်လည်ရယူနိုင်ပါသည်။ ဘာသာပြန် စာမျက်နှာနှင့် ဝန်ဆောင်မှုတစ်ခုတည်းဖြစ်ပြီး နှုန်းထားတူညီကာ ခရက်ဒစ်လက်ကျန်တစ်ခုတည်းမှ ပေးချေရပါသည်။
API သော့ ရယူခြင်း
ဘာသာပြန် စာမျက်နှာတွင် API သော့ ဖန်တီးပါ။ အကောင့်ဝင်ပြီး ညာဘက်အပေါ်ထောင့်ရှိ အကောင့်ကို ဖွင့်ကာ API သော့များအောက်ရှိ ဖန်တီးရန်ကို ရွေးပါ။
တောင်းဆိုချက်တိုင်းတွင် API သော့ကို Authorization: Bearer ept_… အဖြစ် ထည့်ပို့ပါ။ လျှို့ဝှက်ထားပါ။ ဤသော့ကို ရရှိထားသူ မည်သူမဆို သင့်ခရက်ဒစ်များကို သုံးစွဲနိုင်ပါသည်။
နှုန်းထားများ
- ပုံမှန် — စကားလုံး ၂၅၀ လျှင် ၁ ခရက်ဒစ် (အနည်းဆုံး ၁ ခရက်ဒစ်)။
- Pro — စကားလုံး ၇၅ လျှင် ၁ ခရက်ဒစ် (အနည်းဆုံး ၂ ခရက်ဒစ်)။
- အင်္ဂလိပ်ဘာသာ မဟုတ်သော ဘာသာစကားနှစ်မျိုးအကြား ဘာသာပြန်ပါက နှုန်းထား နှစ်ဆဖြစ်ပါသည်။
- ၁၀၀ ခရက်ဒစ် = USD ၁။
ဘာသာပြန်မှု မအောင်မြင်ပါက ခရက်ဒစ်များကို ပြန်အမ်းပါသည်။
API လမ်းကြောင်းများ
အခြေခံ URL — https://translate.edgepedia.ai။ တောင်းဆိုချက်များနှင့် တုံ့ပြန်ချက်များသည် JSON ပုံစံဖြစ်ပြီး အမှားဖြစ်ပါက {"error": "…"} ပုံစံဖြစ်ပါသည်။
GET /api/v1/languages
ဘာသာစကားများနှင့် ဘာသာစကားတစ်ခုစီအတွက် Pro အသုံးပြုနိုင်မှု။
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/languages
GET /api/v1/balance
သင့်ခရက်ဒစ်လက်ကျန်။
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/balance
POST /api/v1/quote
ဘာသာပြန်မှုကို မစတင်ဘဲ နှုန်းထားနှင့် ခန့်မှန်းကြာချိန်ကို ရယူရန်။ mode သည် standard သို့မဟုတ် pro ဖြစ်ပါသည်။
နှုန်းထား မေးမြန်းရာတွင် "source": "auto" ကိုလည်း သုံးနိုင်ပါသည်။ တုံ့ပြန်ချက်တွင် "source" ထဲ၌ တွေ့ရှိသည့် ဘာသာစကားကို "detected": true ဖြင့် ဖော်ပြပါသည်။ ထို့နောက် ထိုဘာသာစကားကုဒ်ဖြင့် ဘာသာပြန်မှုကို စတင်ပါ။
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard"}' \
https://translate.edgepedia.ai/api/v1/quote
POST /api/v1/translations
စာသား သို့မဟုတ် 10 MB အထိရှိသော .txt, .md, .docx, သို့မဟုတ် .pdf ဖိုင်ကို ဘာသာပြန်ရန် စတင်ပါ။ နှုန်းထားသည် သင်မျှော်မှန်းထားသည့် နှုန်းထားနှင့် မတူပါက ငြင်းပယ်စေရန် (409) "expect_credits" ကို ထည့်ပါ။ တုံ့ပြန်ချက်တစ်ခုတည်းတွင် ဘာသာပြန်ပြီးသားစာကို ရယူရန် "wait" (စက္ကန့် ၁၂၀ အထိ) ကို ထည့်ပါ။
curl -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"text": "Your text here.", "source": "en", "target": "ar", "mode": "standard", "wait": 60}' \
https://translate.edgepedia.ai/api/v1/translations
curl -H "Authorization: Bearer $KEY" -F file=@report.docx -F source=en -F target=ar -F mode=standard \
https://translate.edgepedia.ai/api/v1/translations
GET /api/v1/translations/{id}
ဘာသာပြန်မှု အခြေအနေ (queued, running, done, သို့မဟုတ် failed) နှင့် ပြီးဆုံးပါက ဘာသာပြန်စာကို ရယူရန်။ မအောင်မြင်ပါက အကြောင်းရင်းကို ဖော်ပြပါသည်။ ပြီးဆုံးသည့် ဘာသာပြန်စာကို ရက် ၃၀ အတွင်း ရယူနိုင်ပါသည်။
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations/$ID
GET /api/v1/translations/{id}/download
ဖိုင်ဘာသာပြန်မှု ရလဒ် — .docx နှင့် .pdf ဖိုင်များအတွက် .docx၊ .txt နှင့် .md အတွက် စာသား။
curl -H "Authorization: Bearer $KEY" -o translated.docx https://translate.edgepedia.ai/api/v1/translations/$ID/download
GET /api/v1/translations
သင့်ဘာသာပြန်မှုများကို နောက်ဆုံးမှစ၍ ၅၀ အထိ ရယူရန်။
curl -H "Authorization: Bearer $KEY" https://translate.edgepedia.ai/api/v1/translations
အခြေအနေကုဒ်များ
| ကုဒ် | အဓိပ္ပာယ် |
|---|---|
| 200 | OK။ wait ဖြင့် စတင်ထားပါက ဘာသာပြန်မှု ပြီးဆုံးသွားပြီ သို့မဟုတ် မအောင်မြင်ပါ။ |
| 202 | စတင်လိုက်ပါပြီ သို့မဟုတ် wait ကြာပြီးနောက် ဆက်လက်လုပ်ဆောင်နေဆဲဖြစ်ပါသည်။ |
| 400 | ပို့ထားသည့် တောင်းဆိုချက်အတိုင်း ဘာသာပြန်၍ မရပါ။ အမှားဖော်ပြချက်တွင် အကြောင်းရင်း ပါရှိပါသည်။ |
| 401 | API သော့ မပါရှိပါ၊ မသိရှိသော သော့ဖြစ်နေပါသည် သို့မဟုတ် ရုပ်သိမ်းထားပြီးဖြစ်ပါသည်။ |
| 402 | ခရက်ဒစ် မလုံလောက်ပါ။ |
| 404 | သင့်အကောင့်တွင် ထိုဘာသာပြန်မှု မရှိပါ။ |
| 409 | နှုန်းထားသည် သင်သတ်မှတ်ထားသည့် expect_credits နှင့် မတူပါ။ မည်သည့်အခကြေးငွေမျှ မကောက်ခံထားပါ။ |
| 413 | ဖိုင်အရွယ်အစားသည် 10 MB ထက် ကျော်နေပါသည်။ |
| 429 | တစ်မိနစ်အတွင်း တောင်းဆိုချက် ၆၀ ထက် ကျော်နေပါသည်။ Retry-After စက္ကန့်ကြာပြီးနောက် ထပ်ကြိုးစားပါ။ |