Gå til innhold
Norsk
Hent API-nøkkel
API-veiledning

Filer

Vis som Markdown Oppdatert

Modeller som tar imot bilder, video eller lyd, godtar dem i én av tre former. Hver modellside markerer filparameterne sine (for eksempel image, images, videos, audios).

1. En offentlig URL

Enhver https://- (eller http://-)URL som modellen kan laste ned:

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

Filen må være tilgjengelig uten informasjonskapsler eller innlogging og forbli tilgjengelig til forespørselen har startet. Hver modellside viser grensene for størrelse og dimensjoner for filparameterne.

2. En data-URI

Små filer kan legges inn direkte som en data:-URI på opptil 10 MB:

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

Base64 gjør bodyen omtrent en tredel større enn filen, så foretrekk opplastinger for alt som er stort.

3. En opplasting

For lokale filer ber du om en opplastings-URL, gjør PUT av bytene dit og sender den returnerte file_url til modellen. Det er gratis å opprette opplastings-URL-en.

1 · Hent en opplastings-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 · opplasting
{
  "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 · Last opp bytene med nøyaktig de returnerte headerne
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
3 · Bruk file_url som modellens inndata
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": "..."}'
  • Støttede opplastinger: .jpg, .jpeg, .png, .webp (opptil 15 MB) og .mp4, .mov, .webm (opptil 200 MB). Filendelsen angir typen; content_type må samsvare med den.
  • Opplastings-URL-en er gyldig i én time. file_url forblir gyldig.
  • For lyd bruker du en offentlig URL eller en data-URI.

Utdatafiler

Du velger hvor lenge utdatafiler beholdes:

  • For alltid (permanent, standard): til du sletter dem, for 100 API-kreditter (0,10 $) per GB per måned, belastet én gang daglig fra API-saldoen (1 GB = 1024³ byte).
  • 7 dager (temporary): gratis, deretter slettet fra lagringen vår.

Angi standarden med bryteren «Lagre filer for alltid» i dashbordet eller med PATCH /account/storage, og overstyr den per kjøring 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 forespørsel viser sin egen storage (mode, bytes, expires_at, expired). Innstillingen gjelder nye forespørsler; filer du allerede beholder for alltid, blir liggende til du sletter dem med DELETE /requests/{id}/files (se Forespørsler). Hvis API-saldoen ikke kan betale for lagring, får du en e-post og 30 dager til å fylle på før beholdte filer blir midlertidige.