# Comhaid

Glacann samhlacha a thógann íomhánna, físeán nó fuaim leo i gceann ar bith de thrí fhoirm. Marcálann leathanach gach samhla a paraiméadair chomhaid (mar shampla `image`, `images`, `videos`, `audios`).

## 1. URL poiblí

Aon URL `https://` (nó `http://`) is féidir leis an tsamhail a íoslódáil:

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

Caithfidh an comhad a bheith insroichte gan fianáin ná logáil isteach, agus fanacht insroichte go dtí go mbeidh tús curtha leis an iarratas. Liostaíonn leathanach gach samhla teorainneacha méide agus toise a pharaiméadar comhaid.

## 2. URI sonraí

Is féidir comhaid bheaga a chur inlíne mar URI `data:` suas le 10 MB:

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

Méadaíonn Base64 an corp thart ar an tríú cuid i gcomparáid leis an gcomhad, mar sin b’fhearr uaslódálacha d’aon rud mór.

## 3. Uaslódáil

I gcás comhad logánta, iarr URL uaslódála, déan `PUT` de na bearta chuige agus tabhair an `file_url` a tugadh ar ais don tsamhail. Tá cruthú an URL uaslódála saor in aisce.

```bash 1 · Faigh URL uaslódála
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 · uaslódáil
{
  "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 · Uaslódáil na bearta leis na ceanntásca a tugadh ar ais go díreach
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
```

```bash 3 · Úsáid file_url mar ionchur na samhla
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": "..."}'
```

- Uaslódálacha tacaithe: `.jpg`, `.jpeg`, `.png`, `.webp` (suas le 15 MB) agus `.mp4`, `.mov`, `.webm` (suas le 200 MB). Socraíonn an síneadh an cineál; caithfidh `content_type` teacht leis.
- Bíonn an URL uaslódála bailí ar feadh uair an chloig. Fanann an `file_url` bailí.
- Maidir le fuaim, úsáid URL poiblí nó URI sonraí.

## Comhaid aschuir

> [!TIP]
> Cóipeáiltear comhaid ghinte chuig ár stóráil agus tugtar ar ais iad in `outputs[].url` mar naisc ar `content.doitong.com`. Is féidir leat iad a chur díreach isteach i samhail eile, mar shampla íomhá ó shamhail text-to-image isteach i samhail image-to-video.

Roghnaíonn tú cá fhad a choinnítear comhaid aschuir:

- **Go deo** (`permanent`, an réamhshocrú): go dtí go scriosann tú iad, ar 100 creidmheasanna API ($0.10) in aghaidh GB in aghaidh na míosa, gearrtha uair sa lá ó iarmhéid API (1 GB = 1024³ beart).
- **7 lá** (`temporary`): saor in aisce, ansin scriosta ónár stóráil.

Socraigh an réamhshocrú leis an lasc "Coinnigh comhaid go deo" sa [phainéal](https://doitong.com/developers/dashboard#balance) nó le `PATCH /account/storage`, agus sáraigh é in aghaidh an rith le `?storage=temporary` (nó `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"}'
```

Taispeánann gach iarratas a `storage` féin (`mode`, `bytes`, `expires_at`, `expired`). Baineann an socrú le hiarratais nua; fanann comhaid atá á gcoinneáil agat go deo go dtí go scriosann tú iad le `DELETE /requests/{id}/files` (féach [Iarratais](https://doitong.com/developers/docs/requests#delete-files)). Mura féidir le hiarmhéid API íoc as stóráil, seoltar ríomhphost chugat agus bíonn 30 lá agat le breisiú sula n-éiríonn na comhaid choimeádta sealadach.