Faili

Modeļi, kas pieņem attēlus, video vai audio, tos pieņem jebkurā no trim veidiem. Katras modeļa lapas atzīmē tā failu parametrus (piemēram, image, images, videos, audios).

1. Publisks URL#

Jebkurš https:// (vai http://) URL, no kura modelis var lejupielādēt failu:

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

Failam jābūt pieejamam bez sīkfailiem vai pieteikšanās un jāpaliek pieejamam, līdz pieprasījums ir sācies. Katras modeļa lapas uzskaita tā failu parametru izmēra un dimensiju ierobežojumus.

2. Datu URI#

Mazus failus var iekļaut kā data: URI, kura izmērs nepārsniedz 10 MB:

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

Base64 padara ķermeni aptuveni par trešdaļu lielāku nekā fails, tāpēc lieliem failiem dodiet priekšroku augšupielādei.

3. Augšupielāde#

Lokāliem failiem pieprasiet augšupielādes URL, ar PUT augšupielādējiet tajā baitus un nododiet modelim atgriezto file_url. Augšupielādes URL izveide ir bezmaksas.

curl -X POST "https://api.doitong.ru/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.ru/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": "..."}'

• Atbalstītās augšupielādes: .jpg, .jpeg, .png, .webp (līdz 15 MB) un .mp4, .mov, .webm (līdz 200 MB). Paplašinājums nosaka tipu; content_type tam ir jāatbilst.
• Augšupielādes URL ir derīgs vienu stundu. file_url paliek derīgs.
• Audio izmantojiet publisku URL vai datu URI.

Izvades faili#

Jūs izvēlaties, cik ilgi izvades faili tiek glabāti:

• Mūžīgi (permanent, noklusējums): līdz to dzēšanai, par 100 API kredītiem (0,10 $) par GB mēnesī, maksa tiek iekasēta reizi dienā no API atlikuma (1 GB = 1024³ baiti).
• 7 dienas (temporary): bez maksas, pēc tam dzēsti no mūsu krātuves.

Iestatiet noklusējumu ar slēdzi "Glabāt failus mūžīgi" informācijas panelī vai ar PATCH /account/storage, bet ignorējiet to atsevišķai palaišanai ar ?storage=temporary (vai permanent):

curl -X PATCH "https://api.doitong.ru/v1/account/storage" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "temporary"}'

Katrs pieprasījums parāda savu storage (mode, bytes, expires_at, expired). Iestatījums attiecas uz jauniem pieprasījumiem; faili, kurus jau glabājat mūžīgi, paliek līdz to dzēšanai ar DELETE /requests/{id}/files (skatiet Pieprasījumi). Ja API atlikums nevar samaksāt par krātuvi, jūs saņemat e-pastu un 30 dienas laika, lai papildinātu atlikumu, pirms saglabātie faili kļūst pagaidu faili.