အကြောင်းအရာသို့ ကျော်ရန်
API လမ်းညွှန်

ဖိုင်များ

Markdown အဖြစ်ကြည့်ရန် မွမ်းမံထားသည်

ပုံ၊ ဗီဒီယို သို့မဟုတ် အသံကို လက်ခံသော မော်ဒယ်များသည် ၎င်းတို့ကို ပုံစံ 3 မျိုးအနက် မည်သည့်ပုံစံဖြင့်မဆို လက်ခံသည်။ မော်ဒယ်စာမျက်နှာတိုင်းတွင် ၎င်း၏ ဖိုင် ပါရာမီတာများ (ဥပမာ image, images, videos, audios) ကို ဖော်ပြထားသည်။

1. အများမြင်နိုင်သော URL

မော်ဒယ်က ဒေါင်းလုဒ်လုပ်နိုင်သည့် မည်သည့် https:// (သို့မဟုတ် http://) URL မဆို-

JSON
{ "image": "https://example.com/photos/product.jpg" }

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

2. Data URI

ဖိုင်သေးများကို အများဆုံး 10 MB ရှိသော data: URI အဖြစ် တိုက်ရိုက်ထည့်နိုင်သည်-

JSON
{ "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." }

Base64 ကြောင့် ကိုယ်ထည်သည် ဖိုင်ထက် သုံးပုံတစ်ပုံခန့် ပိုကြီးလာသောကြောင့် အရွယ်ကြီးသည့်အရာများအတွက် upload ကို ဦးစားပေးပါ။

3. Upload

စက်တွင်းဖိုင်များအတွက် upload URL တောင်းယူပြီး bytes များကို ထိုနေရာသို့ PUT လုပ်ကာ ပြန်ရလာသော file_url ကို မော်ဒယ်ထံ ပေးပါ။ Upload URL ဖန်တီးခြင်းသည် အခမဲ့ဖြစ်သည်။

1 · Upload URL ရယူရန်
curl -X POST "https://api.doitong.ru/v1/files" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "product.jpg", "content_type": "image/jpeg", "size": 482113}'
201 Created · upload
{
  "object": "upload",
  "upload_url": "https://…signed upload URL…",
  "file_url": "https://content.doitong.com/…/product.jpg",
  "method": "PUT",
  "headers": { "Content-Type": "image/jpeg" },
  "content_type": "image/jpeg",
  "expires_in": 3600,
  "max_bytes": 15728640
}
2 · ပြန်ရလာသော headers များနှင့် အတိအကျ bytes များကို Upload လုပ်ရန်
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
3 · file_url ကို မော်ဒယ်၏ ထည့်သွင်းချက်အဖြစ် အသုံးပြုရန်
curl -X POST "https://api.doitong.ru/v1/run/{model_id}?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "https://content.doitong.com/…/product.jpg", "prompt": "..."}'
  • ထောက်ပံ့ထားသော upload များ: .jpg, .jpeg, .png, .webp (အများဆုံး 15 MB) နှင့် .mp4, .mov, .webm (အများဆုံး 200 MB)။ Extension က type ကို သတ်မှတ်ပြီး content_type သည် ၎င်းနှင့် ကိုက်ညီရမည်။
  • Upload URL သည် တစ်နာရီအထိ အကျုံးဝင်သည်။ file_url သည် ဆက်လက်အကျုံးဝင်သည်။
  • အသံအတွက် အများမြင်နိုင်သော URL သို့မဟုတ် data URI ကို အသုံးပြုပါ။

ထွက်ရလဒ်ဖိုင်များ

ထွက်ရလဒ်ဖိုင်များကို မည်မျှကြာ သိမ်းထားမည်ကို သင်ရွေးချယ်နိုင်သည်-

  • အမြဲတမ်း (permanent, မူလတန်ဖိုး): သင်မဖျက်မချင်း၊ တစ်လလျှင် GB တစ်ခုအတွက် ၁၀၀ API ခရက်ဒစ် (၀.၁၀ $) ကျသင့်မည်ဖြစ်ပြီး API လက်ကျန်မှ တစ်ရက်လျှင် တစ်ကြိမ် ကောက်ခံမည် (1 GB = 1024³ bytes)။
  • ၇ ရက် (temporary): အခမဲ့ဖြစ်ပြီး ထို့နောက် ကျွန်ုပ်တို့၏ သိုလှောင်မှုမှ ဖျက်ပစ်မည်။

dashboard ရှိ "ဖိုင်များကို အမြဲတမ်း သိမ်းဆည်းထားပါ" switch ဖြင့် မူလတန်ဖိုးကို သတ်မှတ်နိုင်သည်၊ သို့မဟုတ် PATCH /account/storage ဖြင့် သတ်မှတ်နိုင်ပြီး run တစ်ခုချင်းစီအတွက် ?storage=temporary (သို့မဟုတ် permanent) ဖြင့် အစားထိုးနိုင်သည်-

terminal
curl -X PATCH "https://api.doitong.ru/v1/account/storage" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "temporary"}'

တောင်းဆိုချက်တိုင်းတွင် ၎င်း၏ကိုယ်ပိုင် storage (mode, bytes, expires_at, expired) ကို ပြသထားသည်။ ဤသတ်မှတ်ချက်သည် တောင်းဆိုချက်အသစ်များအတွက် သက်ရောက်သည်။ သင်အမြဲတမ်း သိမ်းထားပြီးသား ဖိုင်များသည် DELETE /requests/{id}/files ဖြင့် မဖျက်မချင်း ဆက်ရှိနေမည် ( Requests ကို ကြည့်ပါ)။ API လက်ကျန်သည် သိုလှောင်မှုအတွက် ငွေမပေးနိုင်ပါက အီးမေးလ်ရရှိမည်ဖြစ်ပြီး သိမ်းထားသော ဖိုင်များ ယာယီဖြစ်မသွားမီ ငွေဖြည့်ရန် ၃၀ ရက် ရရှိမည်။