# Skrár

Líkön sem taka við myndum, myndbandi eða hljóði samþykkja þau á einn af þremur sniðum. Á hverri líkanasíðu eru
færibreytur fyrir skrár merktar (til dæmis `image`, `images`, `videos`, `audios`).

## 1. Opinber URL-slóð

Hvaða `https://` (eða `http://`) URL-slóð sem líkanið getur sótt:

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

Skráin verður að vera aðgengileg án vafrakaka eða innskráningar og vera aðgengileg þar til beiðnin er hafin. Á hverri líkanasíðu
koma fram takmörk á stærð og víddum færibreyta fyrir skrár.

## 2. Gagnaslóð

Hægt er að setja litlar skrár beint inn sem `data:`-URI sem er allt að 10 MB:

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

Base64 gerir meginmálið um þriðjungi stærra en skrána, svo notaðu frekar upphleðslur fyrir allt sem er stórt.

## 3. Upphleðsla

Fyrir staðbundnar skrár skaltu biðja um upphleðslu-URL, senda bætin þangað með `PUT` og gefa líkaninu upp `file_url` sem skilaðist.
Það er ókeypis að búa til upphleðslu-URL.

```bash 1 · Sækja upphleðslu-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 · upphleðsla
{
  "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 · Hlaða upp bætunum með nákvæmlega hausunum sem skiluðu sér
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
```

```bash 3 · Nota file_url sem inntak líkansins
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": "..."}'
```

- Studdar upphleðslur: `.jpg`, `.jpeg`, `.png`, `.webp` (allt að 15 MB) og `.mp4`, `.mov`, `.webm` (allt að 200 MB).
  Endingin ákvarðar tegundina; `content_type` verður að passa við hana.
- Upphleðslu-URL-ið gildir í eina klukkustund. `file_url` helst gilt.
- Fyrir hljóð skaltu nota opinbera URL-slóð eða gagnaslóð.

## Úttaksskrár

> [!TIP]
> Mynduðum skrám er afritað í geymslu okkar og þær skila sér í `outputs[].url` sem tenglar á `content.doitong.com`. Þú getur
> sent þær beint inn í annað líkan, til dæmis mynd úr texta-í-mynd-líkani inn í myndbandslíkanið.

Þú velur hversu lengi úttaksskrár eru geymdar:

- **Að eilífu** (`permanent`, sjálfgefið): þar til þú eyðir þeim, fyrir 100 API-inneign
  (0,10 $) á hvert GB á mánuði, dregið einu sinni á dag af API-stöðunni (1 GB = 1024³ bæti).
- **7 dagar** (`temporary`): ókeypis, síðan eytt úr geymslu okkar.

Stilltu sjálfgefið gildi með rofanum „Geyma skrár að eilífu“ í [stjórnborðinu](https://doitong.com/developers/dashboard#balance) eða með
`PATCH /account/storage` og yfirskrifaðu það fyrir hverja keyrslu með `?storage=temporary` (eða `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"}'
```

Hver beiðni sýnir sína eigin `storage` (`mode`, `bytes`, `expires_at`, `expired`). Stillingin gildir fyrir nýjar beiðnir;
skrár sem þú geymir nú þegar að eilífu haldast þar til þú eyðir þeim með `DELETE /requests/{id}/files` (sjá
[Beiðnir](https://doitong.com/developers/docs/requests#delete-files)). Ef API-staðan getur ekki greitt fyrir geymslu færðu tölvupóst
og 30 daga til að fylla á áður en geymdar skrár verða tímabundnar.