Fájlok

A képet, videót vagy hangot fogadó modellek háromféle formátumban fogadják el ezeket. Az egyes modelloldalak megjelölik a fájlparamétereiket (például image, images, videos, audios).

1. Nyilvános URL#

Bármely https:// (vagy http://) URL, amelyről a modell le tudja tölteni a fájlt:

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

A fájlnak cookie és bejelentkezés nélkül is elérhetőnek kell lennie, és az elérhetőségét meg kell őriznie a kérés megkezdéséig. Az egyes modelloldalak felsorolják fájlparamétereik méret- és dimenziókorlátait.

2. Data URI#

A kis fájlok legfeljebb 10 MB méretű data: URI-ként beágyazhatók:

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

A Base64 körülbelül egyharmadával növeli meg a törzs méretét a fájlhoz képest, ezért nagyobb fájlokhoz inkább feltöltést használj.

3. Feltöltés#

Helyi fájlok esetén kérj feltöltési URL-t, PUT metódussal töltsd fel oda a bájtokat, majd add át a visszaadott file_url értéket a modellnek. A feltöltési URL létrehozása ingyenes.

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

• Támogatott feltöltések: .jpg, .jpeg, .png, .webp (legfeljebb 15 MB), valamint .mp4, .mov, .webm (legfeljebb 200 MB). A kiterjesztés határozza meg a típust; a content_type értékének egyeznie kell vele.
• A feltöltési URL egy órán át érvényes. A file_url továbbra is érvényes marad.
• Hang esetén használj nyilvános URL-t vagy data URI-t.

Kimeneti fájlok#

Te választod ki, meddig maradjanak meg a kimeneti fájlok:

• Örökre (permanent, az alapértelmezett érték): amíg nem törlöd őket, 100 API-kreditért (0,10 $) GB-onként havonta, naponta egyszer az API-egyenlegből terhelve (1 GB = 1024³ bájt).
• 7 napig (temporary): ingyenes, majd törlődik a tárhelyünkről.

Állítsd be az alapértelmezést a „Fájlok megőrzése örökre” kapcsolóval a vezérlőpulton, vagy a PATCH /account/storage használatával, és futtatásonként írd felül a ?storage=temporary (vagy permanent) paraméterrel:

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

Minden kérés megjeleníti a saját storage objektumát (mode, bytes, expires_at, expired). A beállítás az új kérésekre vonatkozik; a már örökre megőrzött fájlok addig maradnak meg, amíg nem törlöd őket a DELETE /requests/{id}/files használatával (lásd: Kérések). Ha az API-egyenleg nem fedezi a tárhely költségét, e-mailt kapsz, és 30 napod lesz az egyenleg feltöltésére, mielőtt a megőrzött fájlok ideiglenessé válnak.