# ᡶᡳᠯᡝ

ᡤᠠᠳᠠᠨ᠈ ᠰᡠᠨᡤᠠ ᡝᠮᡠ ᡤᡳᠰᡠᠨ ᠪᡝ ᡤᠠᡳᡵᠠ ᠮᠣᠳᡝᠯ ᡝᡵᡝ ᡳᠯᠠᠨ ᠠᡵᠪᡠᠨ ᡳ ᠶᠠᠮᠵᡳ ᠪᡝ ᠠᠯᡳᠮᠪᡳ᠉ ᠮᠣᠳᡝᠯ ᡳ ᡝᠮᡴᡝᠨ ᠠᡶᠠᠨ ᡩᡝ ᡳᠨᡳ ᡶᡳᠯᡝ
ᡳ ᠵᠠᡴᡠᠨ ᠪᡝ ᡨᡝᠮᡤᡝᡨᡠᠯᡝᠮᠪᡳ (ᠵᡝᡵᡤᡳ `image`, `images`, `videos`, `audios`)᠉

## 1. ᡤᡝᡵᡝᠨ ᡳ URL

ᠮᠣᠳᡝᠯ ᡝᠪᡠᠮᡝ ᡤᠠᡳᠮᡠᡨᡝᡵᡝ ᠶᠠᠮᠵᡳ `https://` (ᡝᠮᡠ `http://`) URL:

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

ᡶᡳᠯᡝ ᠪᡝ cookie ᡝᠮᡠ ᡩᠣᠰᡳᠮᠪᡠᡵᡝ ᠪᠠᡳᡨᠠᡴᡡ ᡤᠠᡳᠮᡠᡨᡝᡵᡝ ᠣᠵᠣᡵᠠᡴᡡ᠈ ᡤᡝᡪᡳᠯᡝᠨ ᡩᡝᡵᡳᠪᡠᡵᡝ ᠣᠨᡤᡤᠣᠯᠣ ᡨᡝᡵᡝ ᠠᡵᠠᠮᡝ ᠪᡳᠰᡳᡵᡝ ᠣᠵᠣᡵᠠᡴᡡ᠉ ᠮᠣᠳᡝᠯ ᡳ ᡝᠮᡴᡝᠨ
ᠠᡶᠠᠨ ᡩᡝ ᡶᡳᠯᡝ ᡳ ᠵᠠᡴᡠᠨ ᡳ ᠠᠮᠪᠠᠨ ᠪᠠᡥᠠᠨ ᠠᡵᠪᡠᠨ ᡳ ᡥᡝᠮᠴᡝᠨ ᠪᡝ ᡥᠠᡶᠠᠮᠪᡳ᠉

## 2. ᡩᠠᡳᡨᠠ URI

ᠠᠵᡳᡤᡝ ᡶᡳᠯᡝ ᠪᡝ 10 MB ᡩᡝ ᡳᠰᡳᠨᠠᡵᠠ `data:` URI ᠣᠪᡠᠮᡝ ᡩᡝᡵᡝ ᡩᠣᠯᠣ ᠣᠪᡠᠮᡝ ᠪᡠᠮᡠᡨᡝᠮᠪᡳ:

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

Base64 ᡳ ᠪᡝᠶᡝ ᡶᡳᠯᡝ ᠴᡳ ᡳᠯᠠᠨ ᡠᠪᡠᡳ ᡝᠮᡠ ᡠᠪᡠ ᡨᡠᡨᡨᡠ ᠠᠮᠪᠠ ᠣᠮᠪᡳ᠈ ᡨᡝᡵᡝ ᠠᠮᠪᠠ ᡶᡳᠯᡝ ᠪᡝ ᡩᡝᡴᡩᡝᠪᡠᠮᡝ ᠰᠣᠩᡤᠣᡴᡳ᠉

## 3. ᡩᡝᡴᡩᡝᠪᡠᡵᡝ

ᡩᠠᠰᠠᠨ ᡳ ᡶᡳᠯᡝ ᡩᡝ᠈ ᡩᡝᡴᡩᡝᠪᡠᡵᡝ URL ᠪᡝ ᠪᠠᡳᠮᡝ᠈ ᡨᡝᠨᡩᡝ ᠪᠠᡳᡨ ᠪᡝ `PUT` ᠠᡵᠠᠮᡝ᠈ ᠪᡝᡩᡝᡵᡝᠪᡠᡥᡝ `file_url` ᠪᡝ ᠮᠣᠳᡝᠯ ᡩᡝ ᠪᡠᡵᡝ᠉
ᡩᡝᡴᡩᡝᠪᡠᡵᡝ URL ᠪᡝ ᠠᡵᠠᡵᠠᠩᡤᡝ ᠵᡳᡥᠠ ᠪᠠᡳᡨᠠᡴᡡ᠉

```bash 1 · ᡩᡝᡴᡩᡝᠪᡠᡵᡝ 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}'
```

```json 201 Created · ᡩᡝᡴᡩᡝᠪᡠᡵᡝ
{
  "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 · ᠪᡝᡩᡝᡵᡝᠪᡠᡥᡝ ᡠᠵᡠ ᡥᡝᡵᡤᡝᠨ ᠪᡝ ᠠᡩᠠᠯᡳ ᠪᠠᡳᡨᠠᠯᠠᠮᡝ ᠪᠠᡳᡨ ᠪᡝ ᡩᡝᡴᡩᡝᠪᡠᡵᡝ
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
```

```bash 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": "..."}'
```

- ᠠᠯᡳᠮᠪᡠᡵᡝ ᡩᡝᡴᡩᡝᠪᡠᡵᡝ: `.jpg`, `.jpeg`, `.png`, `.webp` (15 MB ᡩᡝ ᡳᠰᡳᠨᠠᡵᠠ) ᠪᠠᡥᠠᠨ `.mp4`, `.mov`, `.webm` (200 MB ᡩᡝ ᡳᠰᡳᠨᠠᡵᠠ)᠉
  ᡨᡠᡨᠠᠪᡠᡥᠠ ᡥᡝᡵᡤᡝᠨ ᡳ ᡩᡠᡵᡠᠨ ᠪᡝ ᡨᠣᡴᡨᠣᠪᡠᠮᠪᡳ; `content_type` ᡨᡝᡵᡝ ᡩᡝ ᠠᠴᠠᡵᠠ ᠣᠵᠣᡵᠠᡴᡡ᠉
- ᡩᡝᡴᡩᡝᠪᡠᡵᡝ URL ᡝᠮᡠ ᠴᠠᡤᠠᠨ ᡩᡝ ᠪᠠᡳᡨᠠᠯᠠᠮᡠᡨᡝᠮᠪᡳ᠉ `file_url` ᠪᠠᡳᡨᠠᠯᠠᠮᡠᡨᡝᠮᡝ ᠪᡳᠮᠪᡳ᠉
- ᡤᡳᠰᡠᠨ ᡩᡝ᠈ ᡤᡝᡵᡝᠨ ᡳ URL ᡝᠮᡠ ᡩᠠᡳᡨᠠ URI ᠪᡝ ᠪᠠᡳᡨᠠᠯᠠᡵᡝ᠉

## ᠪᡠᠶᡝᠮᡝ ᡶᡳᠯᡝ

> [!TIP]
> ᠠᡵᠠᡥᠠ ᡶᡳᠯᡝ ᠪᡝ ᠮᡝᠨᡳ ᠰᡠᠯᡠᠨ ᡩᡝ ᡩᡠᡵᡳᠪᡠᠮᡝ᠈ `outputs[].url` ᡩᡝ `content.doitong.com` ᡳ ᡥᠣᠯᠪᠣᠨ ᠣᠪᡠᠮᡝ ᠪᡝᡩᡝᡵᡝᠪᡠᠮᠪᡳ᠉ ᠰᡳ
> ᡨᡝᠰᡝ ᠪᡝ ᡤᡠᠸᠠ ᠮᠣᠳᡝᠯ ᡩᡝ ᠰᡳᡩᠠᠨ ᠪᡠᠮᡠᡨᡝᠮᠪᡳ᠈ ᠵᡝᡵᡤᡳ ᠪᡳᡨᡥᡝ ᠴᡳ ᡤᠠᠳᠠᠨ ᠠᡵᠠᡵᠠ ᠮᠣᠳᡝᠯ ᡳ ᡤᠠᠳᠠᠨ ᠪᡝ ᡤᠠᠳᠠᠨ ᠴᡳ ᠰᡠᠨᡤᠠ ᠠᡵᠠᡵᠠ ᠮᠣᠳᡝᠯ ᡩᡝ ᠪᡠᠮᡠᡨᡝᠮᠪᡳ᠉

ᠪᡠᠶᡝᠮᡝ ᡶᡳᠯᡝ ᠪᡝ ᠠᡳᠨᠠᠮᡝ ᡤᠣᡳᡩᠠᠮᡝ ᡝᠪᠴᡝᡵᡝ ᠪᡝ ᠰᡳ ᠰᠣᠩᡤᠣᠮᠪᡳ:

- **᠝ᠮᡤᡳ ᠮᡠᠰᡝ** (`permanent`, ᠵᡠᠯᡝ): ᠰᡳ ᡴᠠᡵᡨᠠᠯᠠᡵᠠ ᡩᡝ ᡳᠰᡳᠨᠠᠯᠠ᠈ GB ᡨᠣᠮᡝ ᠪᡳᠶᠠ ᡨᠣᠮᡝ 100 API ᠵᠠᠯᡤᠠᠨ
  ($0.10) ᠪᡝ API ᠪᠠᠯᠠᠨᠰᡳ ᠴᡳ ᡳᠨᡝᠩᡤᡳ ᡨᠣᠮᡝ ᡝᠮᡠ ᠵᡝᡵᡤᡳ ᡤᠠᡳᠮᠪᡳ (1 GB = 1024³ ᠪᠠᡳᡨ)᠉
- **7 ᡳᠨᡝᠩᡤᡳ** (`temporary`): ᠵᡳᡥᠠ ᠪᠠᡳᡨᠠᡴᡡ᠈ ᡨᡝᡵᡝᠴᡳ ᠮᡝᠨᡳ ᠰᡠᠯᡠᠨ ᠴᡳ ᡴᠠᡵᡨᠠᠯᠠᠮᠪᡳ᠉

[ᡩᠠᠰᠠᡵᠠ ᠰᠠᠮᠴᠠ](https://doitong.com/developers/dashboard#balance) ᡳ "ᡥᡡᠯᡤᡠᠨ ᠪᡝ ᡝᠮᡤᡳ ᠮᡠᠰᡝ ᡩᡠᠯᡝᠮᡝ" ᡳ ᠰᠣᠯᡳᡵᡝ ᡩᡝ ᡝᠮᡠ
`PATCH /account/storage` ᡳ ᠵᡠᠯᡝ ᠪᡝ ᡨᠣᡴᡨᠣᠪᡠᠮᡝ᠈ ᠶᠠᠪᡠᡵᡝ ᡨᠣᠮᡝ `?storage=temporary` (ᡝᠮᡠ `permanent`) ᡳ ᠰᠣᠯᡳᠮᡠᡨᡝᠮᠪᡳ:

```bash
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` ᡳ ᡴᠠᡵᡨᠠᠯᠠᡵᠠ ᡩᡝ ᡳᠰᡳᠨᠠᠯᠠ ᠪᡳᠮᠪᡳ ([ᡤᡝᡪᡳᠯᡝᠨ](https://doitong.com/developers/docs/requests#delete-files)
ᠪᡝ ᡨᡠᠸᠠ)᠉ API ᠪᠠᠯᠠᠨᠰᡳ ᠰᡠᠯᡠᠨ ᡳ ᠵᡳᡥᠠ ᠪᡝ ᠪᡠᠮᡠᡨᡝᡵᠠᡴᡡ ᠣᠴᡳ᠈ ᠰᡳ ᡩᡝ ᡝᠯᡝᡴᡨᡵᠣᠨ ᡳ ᠪᡳᡨᡥᡝ ᠪᡠᠮᠪᡳ᠈
ᡝᠪᠴᡝᡥᡝ ᡶᡳᠯᡝ ᠪᡝ ᡨᡠᡥᡝᡵᡳ ᠣᠪᡠᡵᡝ ᠣᠨᡤᡤᠣᠯᠣ ᠡᠮᡠᠯᡝ ᡩᡝ 30 ᡳᠨᡝᠩᡤᡳ ᠪᡠᠮᠪᡳ᠉