Naar inhoud springen
Nederlands
API-sleutel ophalen
API-handleiding

Bestanden

Als Markdown bekijken Bijgewerkt

Modellen die afbeeldingen, video of audio gebruiken, accepteren deze in een van drie vormen. Elke modelpagina markeert de bestandsparameters (bijvoorbeeld image, images, videos, audios).

1. Een openbare URL

Elke https://- (of http://-)URL die het model kan downloaden:

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

Het bestand moet zonder cookies of login bereikbaar zijn en bereikbaar blijven totdat de request is gestart. Elke modelpagina vermeldt de limieten voor grootte en afmetingen van de bestandsparameters.

2. Een data-URI

Kleine bestanden kunnen inline worden meegestuurd als een data:-URI van maximaal 10 MB:

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

Base64 maakt de body ongeveer een derde groter dan het bestand, dus gebruik voor grote bestanden liever uploads.

3. Een upload

Vraag voor lokale bestanden een upload-URL aan, PUT de bytes daarheen en geef de geretourneerde file_url door aan het model. Het aanmaken van de upload-URL is gratis.

1 · Een upload-URL ophalen
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}'
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 · De bytes uploaden met exact de geretourneerde headers
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
3 · file_url gebruiken als modelinvoer
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": "..."}'
  • Ondersteunde uploads: .jpg, .jpeg, .png, .webp (maximaal 15 MB) en .mp4, .mov, .webm (maximaal 200 MB). De extensie bepaalt het type; content_type moet hiermee overeenkomen.
  • De upload-URL is één uur geldig. De file_url blijft geldig.
  • Gebruik voor audio een openbare URL of een data-URI.

Uitvoerbestanden

Je kiest hoe lang uitvoerbestanden worden bewaard:

  • Voor altijd (permanent, de standaard): totdat je ze verwijdert, voor 100 API-credits ($ 0,10) per GB per maand, één keer per dag afgeschreven van het API-saldo (1 GB = 1024³ bytes).
  • 7 dagen (temporary): gratis, daarna verwijderd uit onze opslag.

Stel de standaard in met de schakelaar "Bestanden voor altijd bewaren" in het dashboard of met PATCH /account/storage, en overschrijf deze per run met ?storage=temporary (of permanent):

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

Elke request toont zijn eigen storage (mode, bytes, expires_at, expired). De instelling geldt voor nieuwe requests; bestanden die je al voor altijd bewaart, blijven staan totdat je ze verwijdert met DELETE /requests/{id}/files (zie Requests). Als het API-saldo de opslag niet kan betalen, ontvang je een e-mail en heb je 30 dagen om op te waarderen voordat bewaarde bestanden tijdelijk worden.