# פֿײַלן

מאָדעלן וואָס נעמען בילדער, ווידעא אָדער אַודיאָ אָננעמען זיי אין איינעם פֿון דרײַ פֿאָרמעס. יעדע מאָדעל־זײַט צייכנט אָן אירע פֿײַל־פּאַראַמעטערס (למשל `image`, `images`, `videos`, `audios`).

## 1. אַ פּובליק URL

יעדע `https://` (אָדער `http://`) URL וואָס דער מאָדעל קען דאַונלאָודן:

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

די פֿײַל מוז זײַן דערגרייכבאַר אָן קיכלעך אָדער לאָגין, און בלײַבן דערגרייכבאַר ביז די בקשה האָט אָנגעהויבן. יעדע מאָדעל־זײַט ליסטעט די גרייס־ און דימענסיע־לימיטן פֿון אירע פֿײַל־פּאַראַמעטערס.

## 2. אַ data URI

קליינע פֿײַלן קענען גיין אינעווייניק ווי אַ `data:` URI ביז 10 MB:

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

Base64 מאַכט דעם גוף בערך אַ דריטל גרעסער ווי די פֿײַל, דערפֿאַר זאָלט איר בעסער נוצן אויפֿלאָדונגען פֿאַר עפּעס גרויס.

## 3. אַן אויפֿלאָדונג

פֿאַר לאָקאַלע פֿײַלן, בעטט אַן אויפֿלאָדונג־URL, טוט `PUT` די בײַטעס אַהין, און גיט איבער דעם צוריקגעגעבן `file_url` צום מאָדעל. שאַפֿן די אויפֿלאָדונג־URL איז פֿרײַ.

```bash 1 · באַקומען אַן אויפֿלאָדונג־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 · אויפֿלאָדונג
{
  "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.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": "..."}'
```

- געשטיצטע אויפֿלאָדונגען: `.jpg`, `.jpeg`, `.png`, `.webp` (ביז 15 MB) און `.mp4`, `.mov`, `.webm` (ביז 200 MB). די עקסטענסיע שטעלט דעם טיפּ; `content_type` מוז זיך צופּאַסן צו אים.
- די אויפֿלאָדונג־URL איז גילטיק איין שעה. דער `file_url` בלײַבט גילטיק.
- פֿאַר אַודיאָ ניצט אַ פּובליק URL אָדער אַ data URI.

## רעזולטאַט־פֿײַלן

> [!TIP]
> געשאַפֿענע פֿײַלן ווערן קאַפּירט אין אונדזער סטאָרידזש און צוריקגעגעבן אין `outputs[].url` ווי פֿאַרבינדונגען אויף `content.doitong.com`. איר קענט זיי גלײַך אַרײַנגעבן אין אַן אַנדער מאָדעל, למשל אַ בילד פֿון אַ text-to-image מאָדעל אין אַן image-to-video מאָדעל.

איר קלייבט ווי לאַנג די רעזולטאַט־פֿײַלן ווערן געהאַלטן:

- **אויף אייביק** (`permanent`, דער סטאַנדאַרט): ביז איר מעקט זיי אויס, פֿאַר 100 API קרעדיטן (⁨$ 0.10⁩) פּער GB פּער חודש, אָפּגעצאָלט איינמאָל אַ טאָג פֿונעם API באַלאַנס (1 GB = 1024³ bytes).
- **7 טעג** (`temporary`): פֿרײַ, דערנאָך אויסגעמעקט פֿון אונדזער סטאָרידזש.

שטעלט דעם סטאַנדאַרט מיטן "האַלטן טעקעס אויף אייביק" באַשטימער אינעם [דאַשבאָרד](https://doitong.com/developers/dashboard#balance) אָדער מיט `PATCH /account/storage`, און איבעררײַסט עס פּער לויפֿ מיט `?storage=temporary` (אָדער `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"}'
```

יעדע בקשה ווײַזט איר אייגענעם `storage` (`mode`, `bytes`, `expires_at`, `expired`). די שטעלונג גילט פֿאַר נײַע בקשות; פֿײַלן וואָס איר האַלט שוין אויף אייביק בלײַבן ביז איר מעקט זיי אויס מיט `DELETE /requests/{id}/files` (זע [בקשות](https://doitong.com/developers/docs/requests#delete-files)). אויב דער API באַלאַנס קען נישט באַצאָלן פֿאַר סטאָרידזש, באַקומען איר אַן אימעיל און 30 טעג צו לאָדן אויפֿ איידער די געהאַלטענע פֿײַלן ווערן צײַטווײַליק.