Leum chun t-susbaint
Stiùireadh API

Faidhlichean

Seall mar Markdown Air ùrachadh

Gabhaidh modalan a ghabhas ìomhaighean, bhidio no claisneachd riutha ann an gin de thrì riochdan. Bidh gach duilleag mhodail a’ comharrachadh a pharamadairean faidhle (mar eisimpleir image, images, videos, audios).

1. URL poblach

URL https:// (no http://) sam bith as urrainn don mhodail a luchdachadh a-nuas:

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

Feumaidh am faidhle a bhith ruigsinneach gun bhriosgaidean no logadh a-steach, agus fuireach ruigsinneach gus an tòisich an t-iarrtas. Tha gach duilleag mhodail a’ liostadh crìochan meud is tomhais nam paramadairean faidhle aige.

2. URI dàta

Faodar faidhlichean beaga a chur a-staigh mar URI data: suas ri 10 MB:

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

Nì Base64 an corp mu thrian nas motha na am faidhle, mar sin b’ fheàrr luchdaidhean suas airson rud sam bith mòr.

3. Luchdadh suas

Airson faidhlichean ionadail, iarr URL luchdaidh suas, dèan PUT air na bytes sin, agus cuir an file_url a thill dhan mhodail. Tha cruthachadh URL luchdaidh suas an-asgaidh.

1 · Faigh URL luchdaidh suas
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 · luchdadh suas
{
  "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 · Luchdaich suas na bytes leis na cinn a thill dìreach mar a tha
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
3 · Cleachd file_url mar in-chur a’ mhodail
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": "..."}'
  • Luchdaidhean suas le taic: .jpg, .jpeg, .png, .webp (suas ri 15 MB) agus .mp4, .mov, .webm (suas ri 200 MB). Suidhichidh an leudachan an seòrsa; feumaidh content_type a bhith co-ionann ris.
  • Tha an URL luchdaidh suas dligheach airson uair a thìde. Bidh an file_url dligheach fhathast.
  • Airson claisneachd, cleachd URL poblach no URI dàta.

Faidhlichean às-chuir

Taghaidh tu dè cho fada ’s a thèid faidhlichean às-chuir a chumail:

  • Gu bràth (permanent, am bun-roghainn): gus an sguab thu às iad, airson 100 creideasan API ($0.10) gach GB gach mìos, air an chìsadh aon turas san latha bhon iarmad API (1 GB = 1024³ bytes).
  • 7 latha (temporary): an-asgaidh, agus an uair sin air an sguabadh às bhon stòradh againn.

Suidhich am bun-roghainn leis an tionndadh "Cùm faidhlichean gu bràth" san deas-bhòrd no le PATCH /account/storage, agus cuir thairis e gach ruith le ?storage=temporary (no permanent):

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

Tha an storage aige fhèin aig gach iarrtas (mode, bytes, expires_at, expired). Tha an suidheachadh a’ buntainn ri iarrtasan ùra; fuirichidh faidhlichean a chumas tu gu bràth gus an sguab thu às iad le DELETE /requests/{id}/files (faic Iarrtasan). Mur urrainn don iarmad API pàigheadh airson stòraidh, gheibh thu post-d agus 30 latha airson cur-ris mus fàs na faidhlichean glèidhte sealach.