# ဖိုင်များ

ပုံ၊ ဗီဒီယို သို့မဟုတ် အသံကို လက်ခံသော မော်ဒယ်များသည် ၎င်းတို့ကို ပုံစံ 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 ဖန်တီးခြင်းသည် အခမဲ့ဖြစ်သည်။

```bash 1 · Upload URL ရယူရန်
curl -X POST "https://api.doitong.com/v1/files" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "product.jpg", "content_type": "image/jpeg", "size": 482113}'
```

```json 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
}
```

```bash 2 · ပြန်ရလာသော headers များနှင့် အတိအကျ bytes များကို Upload လုပ်ရန်
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
```

```bash 3 · file_url ကို မော်ဒယ်၏ ထည့်သွင်းချက်အဖြစ် အသုံးပြုရန်
curl -X POST "https://api.doitong.com/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 ကို အသုံးပြုပါ။

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

> [!TIP]
> ဖန်တီးထားသော ဖိုင်များကို ကျွန်ုပ်တို့၏ သိုလှောင်မှုထဲသို့ ကူးယူပြီး `content.doitong.com` ပေါ်ရှိ လင့်ခ်များအဖြစ် `outputs[].url` တွင် ပြန်ပေးသည်။ ၎င်းတို့ကို
> အခြားမော်ဒယ်ထဲသို့ တိုက်ရိုက်ပေးနိုင်သည်။ ဥပမာ text-to-image မော်ဒယ်မှ ပုံတစ်ပုံကို image-to-video မော်ဒယ်ထဲသို့ ပေးနိုင်သည်။

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

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

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

```bash
curl -X PATCH "https://api.doitong.com/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](https://doitong.com/developers/docs/requests#delete-files) ကို ကြည့်ပါ)။ API လက်ကျန်သည် သိုလှောင်မှုအတွက် ငွေမပေးနိုင်ပါက အီးမေးလ်ရရှိမည်ဖြစ်ပြီး
သိမ်းထားသော ဖိုင်များ ယာယီဖြစ်မသွားမီ ငွေဖြည့်ရန် ၃၀ ရက် ရရှိမည်။