Gå til indhold
Dansk
Hent API-nøgle
API-guide

Filer

Vis som Markdown Opdateret

Modeller, der tager billeder, video eller lyd, accepterer dem i en af tre former. Hver modelside markerer dens filparametre (f.eks. image, images, videos, audios).

1. En offentlig URL

Enhver https://- (eller http://-)URL, som modellen kan downloade:

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

Filen skal kunne tilgås uden cookies eller login og forblive tilgængelig, indtil anmodningen er startet. Hver modelside viser størrelses- og dimensionsgrænserne for dens filparametre.

2. En data-URI

Små filer kan indsættes direkte som en data:-URI på op til 10 MB:

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

Base64 gør brødteksten omkring en tredjedel større end filen, så foretræk uploads til alt stort.

3. En upload

For lokale filer skal du anmode om en upload-URL, PUT bytesene dertil og sende den returnerede file_url til modellen. Det er gratis at oprette upload-URL'en.

1 · Hent en upload-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 · upload
{
  "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 · Upload bytesene med præcis de returnerede headers
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
3 · Brug file_url som modelinput
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": "..."}'
  • Understøttede uploads: .jpg, .jpeg, .png, .webp (op til 15 MB) og .mp4, .mov, .webm (op til 200 MB). Filendelsen angiver typen; content_type skal stemme overens med den.
  • Upload-URL'en er gyldig i én time. file_url forbliver gyldig.
  • Til lyd skal du bruge en offentlig URL eller en data-URI.

Outputfiler

Du vælger, hvor længe outputfilerne opbevares:

  • For altid (permanent, standarden): indtil du sletter dem, for 100 API-kreditter (0,10 $) pr. GB pr. måned, opkrævet én gang dagligt fra API-saldoen (1 GB = 1024³ bytes).
  • 7 dage (temporary): gratis, derefter slettes de fra vores lagring.

Angiv standarden med kontakten "Gem filer for altid" i dashboardet eller med PATCH /account/storage, og tilsidesæt den pr. kørsel med ?storage=temporary (eller permanent):

terminal
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 anmodning viser sin egen storage (mode, bytes, expires_at, expired). Indstillingen gælder for nye anmodninger; filer, du allerede opbevarer for altid, bliver, indtil du sletter dem med DELETE /requests/{id}/files (se Anmodninger). Hvis API-saldoen ikke kan betale for lagring, får du en e-mail og 30 dage til at fylde saldoen op, før de opbevarede filer bliver midlertidige.