Skrár

Líkön sem taka við myndum, myndbandi eða hljóði samþykkja þau á einn af þremur sniðum. Á hverri líkanasíðu eru færibreytur fyrir skrár merktar (til dæmis image, images, videos, audios).

1. Opinber URL-slóð#

Hvaða https:// (eða http://) URL-slóð sem líkanið getur sótt:

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

Skráin verður að vera aðgengileg án vafrakaka eða innskráningar og vera aðgengileg þar til beiðnin er hafin. Á hverri líkanasíðu koma fram takmörk á stærð og víddum færibreyta fyrir skrár.

2. Gagnaslóð#

Hægt er að setja litlar skrár beint inn sem data:-URI sem er allt að 10 MB:

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

Base64 gerir meginmálið um þriðjungi stærra en skrána, svo notaðu frekar upphleðslur fyrir allt sem er stórt.

3. Upphleðsla#

Fyrir staðbundnar skrár skaltu biðja um upphleðslu-URL, senda bætin þangað með PUT og gefa líkaninu upp file_url sem skilaðist. Það er ókeypis að búa til upphleðslu-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}'

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

• Studdar upphleðslur: .jpg, .jpeg, .png, .webp (allt að 15 MB) og .mp4, .mov, .webm (allt að 200 MB). Endingin ákvarðar tegundina; content_type verður að passa við hana.
• Upphleðslu-URL-ið gildir í eina klukkustund. file_url helst gilt.
• Fyrir hljóð skaltu nota opinbera URL-slóð eða gagnaslóð.

Úttaksskrár#

Þú velur hversu lengi úttaksskrár eru geymdar:

• Að eilífu (permanent, sjálfgefið): þar til þú eyðir þeim, fyrir 100 API-inneign (0,10 $) á hvert GB á mánuði, dregið einu sinni á dag af API-stöðunni (1 GB = 1024³ bæti).
• 7 dagar (temporary): ókeypis, síðan eytt úr geymslu okkar.

Stilltu sjálfgefið gildi með rofanum „Geyma skrár að eilífu“ í stjórnborðinu eða með PATCH /account/storage og yfirskrifaðu það fyrir hverja keyrslu með ?storage=temporary (eða 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"}'

Hver beiðni sýnir sína eigin storage (mode, bytes, expires_at, expired). Stillingin gildir fyrir nýjar beiðnir; skrár sem þú geymir nú þegar að eilífu haldast þar til þú eyðir þeim með DELETE /requests/{id}/files (sjá Beiðnir). Ef API-staðan getur ekki greitt fyrir geymslu færðu tölvupóst og 30 daga til að fylla á áður en geymdar skrár verða tímabundnar.