טעקעס

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

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

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

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

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

2. אַ data URI#

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

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

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

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

פֿאַר לאָקאַלע פֿײַלן, בעטט אַן אויפֿלאָדונג־URL, טוט PUT די בײַטעס אַהין, און גיט איבער דעם צוריקגעגעבן file_url צום מאָדעל. שאַפֿן די אויפֿלאָדונג־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}'

{
  "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
}

curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg

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.

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

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

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

שטעלט דעם סטאַנדאַרט מיטן "האַלטן טעקעס אויף אייביק" באַשטימער אינעם דאַשבאָרד אָדער מיט PATCH /account/storage, און איבעררײַסט עס פּער לויפֿ מיט ?storage=temporary (אָדער permanent):

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 (זע בקשות). אויב דער API באַלאַנס קען נישט באַצאָלן פֿאַר סטאָרידזש, באַקומען איר אַן אימעיל און 30 טעג צו לאָדן אויפֿ איידער די געהאַלטענע פֿײַלן ווערן צײַטווײַליק.