Pereiti prie turinio
Lietuvių
Gauti API raktą
API vadovas

Failai

Peržiūrėti kaip Markdown Atnaujinta

Modeliai, priimantys vaizdus, vaizdo įrašus arba garsą, juos priima vienu iš trijų būdų. Kiekvieno modelio puslapyje pažymėti jo failų parametrai (pavyzdžiui, image, images, videos, audios).

1. Viešas URL

Bet kuris https:// (arba http://) URL, kurį modelis gali atsisiųsti:

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

Failas turi būti pasiekiamas be slapukų ar prisijungimo ir išlikti pasiekiamas, kol užklausa bus pradėta vykdyti. Kiekvieno modelio puslapyje pateikiami jo failų parametrų dydžio ir matmenų apribojimai.

2. Duomenų URI

Maži failai gali būti įterpti kaip iki 10 MB dydžio data: URI:

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

Dėl Base64 turinys tampa maždaug trečdaliu didesnis už failą, todėl dideliems failams rinkitės įkėlimą.

3. Įkėlimas

Vietiniams failams paprašykite įkėlimo URL, nusiųskite baitus naudodami PUT, tada perduokite modeliui grąžintą file_url. Įkėlimo URL sukūrimas yra nemokamas.

1 · Gauti įkėlimo URL
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}'
201 Created · įkėlimas
{
  "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
}
2 · Įkelti baitus naudojant tiksliai grąžintas antraštes
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
3 · Naudoti file_url kaip modelio įvestį
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": "..."}'
  • Palaikomi įkėlimai: .jpg, .jpeg, .png, .webp (iki 15 MB) ir .mp4, .mov, .webm (iki 200 MB). Plėtinys nustato tipą; content_type turi jį atitikti.
  • Įkėlimo URL galioja vieną valandą. file_url lieka galioti.
  • Garsui naudokite viešą URL arba duomenų URI.

Išvesties failai

Jūs pasirenkate, kiek laiko saugoti išvesties failus:

  • Neribotą laiką (permanent, numatytasis): kol juos ištrinsite, už 100 API kreditų (0,10 $) už GB per mėnesį, mokestį kartą per dieną nuskaičiuojant iš API likučio (1 GB = 1024³ baitai).
  • 7 dienas (temporary): nemokamai, tada ištrinami iš mūsų saugyklos.

Nustatykite numatytąją reikšmę naudodami jungiklį „Saugoti failus neribotą laiką“ valdymo skydelyje arba PATCH /account/storage, o vykdymui nepaisykite šios nuostatos naudodami ?storage=temporary (arba permanent):

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

Kiekvienoje užklausoje rodoma jos storage (mode, bytes, expires_at, expired). Nuostata taikoma naujoms užklausoms; failai, kuriuos jau saugote neribotą laiką, lieka tol, kol juos ištrinsite naudodami DELETE /requests/{id}/files (žr. Užklausos). Jei API likučio nepakanka saugyklai apmokėti, gaunate el. laišką ir 30 dienų papildyti likutį, kol saugomi failai taps laikini.