# Fiillat

Modeallat mat váldet govaid, video dahje jiena dohkkehit daid juohke golbma hámiin. Juohke modeallasiidu merket dan fiilaparamehtera (omd. `image`, `images`, `videos`, `audios`).

## 1. Almmolaš URL

Juohke `https://` (dahje `http://`) URL maid modealla sáhttá viežžat:

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

Fiila ferte leat olámuttus keksit dahje beassanlogahallama haga, ja oažžut olámuttos dassážii go jearaldat lea álggahuvvon. Juohke modeallasiidu listá dan fiilaparamehteriid sturrodat- ja dimenšuvdnarájáid.

## 2. Data URI

Unna fiillat sáhttet leat njuolgga `data:` URI:n, gitta 10 MB:

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

Base64 dahká rumaša sullii goalmmádasa stuorát go fiila, nu ahte vállje uploađaid juoga stuorra várás.

## 3. Uploađat

Báikkálaš fiillaid várás jeara uploađa URL, `PUT` bytes:at dohko, ja sádde máhcahtuvvon `file_url` modeallii. Uploađa URL ráhkadeapmi lea nu ahte nu.

```bash 1 · Oza uploađa 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 · uploahtta
{
  "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 · Uploađa bytes:at dárkilit máhcahtuvvon vuolábealčállagiiguin
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
```

```bash 3 · Geavat file_url modealla sisa-addin
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": "..."}'
```

- Dugdjon uploađat: `.jpg`, `.jpeg`, `.png`, `.webp` (gitta 15 MB) ja `.mp4`, `.mov`, `.webm` (gitta 200 MB). Lassehaš mearrida šládja; `content_type` ferte heivet dasa.
- Uploađa URL gusto ovtta diimmu. `file_url` báhcá gustojeaddjin.
- Jiena várás geavat almmolaš URL dahje data URI.

## Boađusfiillat

> [!TIP]
> Ráhkaduvvon fiillat kopierejuvvojit min vurkemii ja máhcahuvvojit `outputs[].url`-sajádatin lenkeálbmájin `content.doitong.com`-s. Sáhtát sáddet daid njuolgga eará modeallii, omd. govva text-to-image-modeallas image-to-video-modeallii.

Don válljet man guhkes boađusfiillat vurkejuvvojit:

- **Álo** (`permanent`, standárda): gitta go don daid sihkut, 100 API-kredihtta (0,10 $) juohke GB juohke mánus, máksojuvvon oktii beaivvis API saldos (1 GB = 1024³ bytes).
- **7 beaivvi** (`temporary`): nu ahte nu, de sihkojuvvon min vurkemis.

Bija standárda "Vurke fiillaid álo" heivehusain [dashboard](https://doitong.com/developers/dashboard#balance)-siiddus dahje `PATCH /account/storage` bokte, ja badjá dan juohke geavahandárbbu várás `?storage=temporary` (dahje `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"}'
```

Juohke jearaldat čájeha iežas `storage` (`mode`, `bytes`, `expires_at`, `expired`). Sajádat gusto ođđa jearaldagaide; fiillat maid don juo vurket álo báhcit dassážii go don daid sihkut `DELETE /requests/{id}/files` bokte (geahča [Jearaldagat](https://doitong.com/developers/docs/requests#delete-files)). Go API saldo ii sáhte máksit vurkemis, oaččut e-poasta ja 30 beaivvi lasáhussii ovdal go vurkejuvvon fiillat šaddet gaskaboddosažžan.