Ruka hadi kwenye maudhui
Kiswahili
Pata ufunguo wa API
Mwongozo wa API

Faili

Tazama kama Markdown Imesasishwa

Modeli zinazopokea picha, video au sauti hukubali katika aina yoyote kati ya tatu. Kila ukurasa wa modeli huashiria vigezo vyake vya mafaili (kwa mfano image, images, videos, audios).

1. URL ya umma

URL yoyote ya https:// (au http://) ambayo modeli inaweza kupakua:

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

Faili lazima lifikike bila vidakuzi au kuingia, na liendelee kufikika hadi ombi lianze. Kila ukurasa wa modeli huorodhesha mipaka ya ukubwa na vipimo ya vigezo vyake vya mafaili.

2. URI ya data

Mafaili madogo yanaweza kuwekwa ndani kama URI ya data: ya hadi MB 10:

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

Base64 hufanya mwili uwe mkubwa kwa takriban theluthi moja kuliko faili, kwa hiyo pendelea upakiaji kwa kitu kikubwa.

3. Upakiaji

Kwa mafaili ya ndani, omba URL ya kupakia, PUT baiti hapo, kisha pitisha file_url iliyorejeshwa kwa modeli. Kuunda URL ya kupakia ni bila malipo.

1 · Pata URL ya kupakia
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 · kupakia
{
  "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 · Pakia baiti kwa vichwa vilivyorudishwa sawasawa
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
3 · Tumia file_url kama ingizo la modeli
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": "..."}'
  • Vipakiaji vinavyotumika: .jpg, .jpeg, .png, .webp (hadi MB 15) na .mp4, .mov, .webm (hadi MB 200). Kiendelezi huweka aina; content_type lazima ilingane nayo.
  • URL ya kupakia ni halali kwa saa moja. file_url hubaki halali.
  • Kwa sauti, tumia URL ya umma au URI ya data.

Mafaili ya tokeo

Unachagua muda wa kuhifadhi mafaili ya tokeo:

  • Milele (permanent, chaguomsingi): hadi uyafute, kwa 100 krediti za API ($ 0.10) kwa GB kwa mwezi, hutozwa mara moja kwa siku kutoka salio la API (1 GB = 1024³ baiti).
  • Siku 7 (temporary): bila malipo, kisha hufutwa kutoka kwenye hifadhi yetu.

Weka chaguo-msingi kwa swichi ya "Hifadhi faili milele" kwenye dashibodi au kwa PATCH /account/storage, na uibatilie kwa kila uendeshaji kwa ?storage=temporary (au permanent):

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

Kila ombi huonyesha storage yake (mode, bytes, expires_at, expired). Mpangilio hutumika kwa maombi mapya; mafaili ambayo tayari unahifadhi milele hubaki hadi uyafute kwa DELETE /requests/{id}/files (angalia Maombi). Salio la API lisipoweza kulipia hifadhi, utapata barua pepe na siku 30 za kuongeza salio kabla mafaili yaliyohifadhiwa kuwa ya muda.