Datoteke

Modeli koji prihvaćaju slike, video ili audio primaju ih u jednom od tri oblika. Svaka stranica modela označava svoje parametre za datoteke (na primjer image, images, videos, audios).

1. Javni URL#

Bilo koji URL https:// (ili http://) koji model može preuzeti:

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

Datoteka mora biti dostupna bez kolačića ili prijave i ostati dostupna dok zahtjev ne započne. Svaka stranica modela navodi ograničenja veličine i dimenzija svojih parametara za datoteke.

2. URI podataka#

Male datoteke mogu se umetnuti kao data: URI veličine do 10 MB:

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

Base64 povećava tijelo za približno trećinu u odnosu na datoteku, pa za sve veće datoteke radije upotrijebite prijenose.

3. Prijenos#

Za lokalne datoteke zatražite URL za prijenos, pošaljite bajtove pomoću PUT i proslijedite vraćeni file_url modelu. Stvaranje URL-a za prijenos je besplatno.

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": "..."}'

• Podržani prijenosi: .jpg, .jpeg, .png, .webp (do 15 MB) i .mp4, .mov, .webm (do 200 MB). Ekstenzija određuje vrstu; content_type joj mora odgovarati.
• URL za prijenos vrijedi jedan sat. file_url ostaje važeći.
• Za audio upotrijebite javni URL ili URI podataka.

Izlazne datoteke#

Odabirete koliko dugo se izlazne datoteke čuvaju:

• Zauvijek (permanent, zadano): dok ih ne izbrišete, za 100 API kredita (0,10 $) po GB mjesečno, naplaćeno jednom dnevno sa stanja API-ja (1 GB = 1024³ bajtova).
• 7 dana (temporary): besplatno, zatim se brišu iz naše pohrane.

Postavite zadano pomoću prekidača "Čuvaj datoteke zauvijek" na nadzornoj ploči ili pomoću PATCH /account/storage, a nadjačajte po pokretanju s ?storage=temporary (ili 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"}'

Svaki zahtjev prikazuje vlastiti storage (mode, bytes, expires_at, expired). Postavka se primjenjuje na nove zahtjeve; datoteke koje već čuvate zauvijek ostaju dok ih ne izbrišete pomoću DELETE /requests/{id}/files (pogledajte Zahtjevi). Ako stanje API-ja ne može platiti pohranu, dobit ćete e-poruku i 30 dana za nadoplatu prije nego što čuvane datoteke postanu privremene.