# Faidhlichean

Gabhaidh modalan a ghabhas ìomhaighean, bhidio no claisneachd riutha ann an gin de thrì riochdan. Bidh gach duilleag mhodail a’ comharrachadh a pharamadairean faidhle (mar eisimpleir `image`, `images`, `videos`, `audios`).

## 1. URL poblach

URL `https://` (no `http://`) sam bith as urrainn don mhodail a luchdachadh a-nuas:

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

Feumaidh am faidhle a bhith ruigsinneach gun bhriosgaidean no logadh a-steach, agus fuireach ruigsinneach gus an tòisich an t-iarrtas. Tha gach duilleag mhodail a’ liostadh crìochan meud is tomhais nam paramadairean faidhle aige.

## 2. URI dàta

Faodar faidhlichean beaga a chur a-staigh mar URI `data:` suas ri 10 MB:

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

Nì Base64 an corp mu thrian nas motha na am faidhle, mar sin b’ fheàrr luchdaidhean suas airson rud sam bith mòr.

## 3. Luchdadh suas

Airson faidhlichean ionadail, iarr URL luchdaidh suas, dèan `PUT` air na bytes sin, agus cuir an `file_url` a thill dhan mhodail. Tha cruthachadh URL luchdaidh suas an-asgaidh.

```bash 1 · Faigh URL luchdaidh suas
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 · luchdadh suas
{
  "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 · Luchdaich suas na bytes leis na cinn a thill dìreach mar a tha
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
```

```bash 3 · Cleachd file_url mar in-chur a’ mhodail
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": "..."}'
```

- Luchdaidhean suas le taic: `.jpg`, `.jpeg`, `.png`, `.webp` (suas ri 15 MB) agus `.mp4`, `.mov`, `.webm` (suas ri 200 MB). Suidhichidh an leudachan an seòrsa; feumaidh `content_type` a bhith co-ionann ris.
- Tha an URL luchdaidh suas dligheach airson uair a thìde. Bidh an `file_url` dligheach fhathast.
- Airson claisneachd, cleachd URL poblach no URI dàta.

## Faidhlichean às-chuir

> [!TIP]
> Thèid faidhlichean a chaidh a chruthachadh a chopaigeadh dhan stòradh againn agus an tilleadh ann an `outputs[].url` mar cheanglaichean air `content.doitong.com`. Faodaidh tu an cur dìreach a-steach do mhodail eile, mar eisimpleir ìomhaigh bho mhodail text-to-image a-steach do mhodail image-to-video.

Taghaidh tu dè cho fada ’s a thèid faidhlichean às-chuir a chumail:

- **Gu bràth** (`permanent`, am bun-roghainn): gus an sguab thu às iad, airson 100 creideasan API ($0.10) gach GB gach mìos, air an chìsadh aon turas san latha bhon iarmad API (1 GB = 1024³ bytes).
- **7 latha** (`temporary`): an-asgaidh, agus an uair sin air an sguabadh às bhon stòradh againn.

Suidhich am bun-roghainn leis an tionndadh "Cùm faidhlichean gu bràth" san [deas-bhòrd](https://doitong.com/developers/dashboard#balance) no le `PATCH /account/storage`, agus cuir thairis e gach ruith le `?storage=temporary` (no `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"}'
```

Tha an `storage` aige fhèin aig gach iarrtas (`mode`, `bytes`, `expires_at`, `expired`). Tha an suidheachadh a’ buntainn ri iarrtasan ùra; fuirichidh faidhlichean a chumas tu gu bràth gus an sguab thu às iad le `DELETE /requests/{id}/files` (faic [Iarrtasan](https://doitong.com/developers/docs/requests#delete-files)). Mur urrainn don iarmad API pàigheadh airson stòraidh, gheibh thu post-d agus 30 latha airson cur-ris mus fàs na faidhlichean glèidhte sealach.