Léim chuig an ábhar
Gaeilge
Faigh eochair API
Treoir API

Comhaid

Féach mar Markdown Nuashonraithe

Glacann samhlacha a thógann íomhánna, físeán nó fuaim leo i gceann ar bith de thrí fhoirm. Marcálann leathanach gach samhla a paraiméadair chomhaid (mar shampla image, images, videos, audios).

1. URL poiblí

Aon URL https:// (nó http://) is féidir leis an tsamhail a íoslódáil:

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

Caithfidh an comhad a bheith insroichte gan fianáin ná logáil isteach, agus fanacht insroichte go dtí go mbeidh tús curtha leis an iarratas. Liostaíonn leathanach gach samhla teorainneacha méide agus toise a pharaiméadar comhaid.

2. URI sonraí

Is féidir comhaid bheaga a chur inlíne mar URI data: suas le 10 MB:

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

Méadaíonn Base64 an corp thart ar an tríú cuid i gcomparáid leis an gcomhad, mar sin b’fhearr uaslódálacha d’aon rud mór.

3. Uaslódáil

I gcás comhad logánta, iarr URL uaslódála, déan PUT de na bearta chuige agus tabhair an file_url a tugadh ar ais don tsamhail. Tá cruthú an URL uaslódála saor in aisce.

1 · Faigh URL uaslódála
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 · uaslódáil
{
  "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 · Uaslódáil na bearta leis na ceanntásca a tugadh ar ais go díreach
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
3 · Úsáid file_url mar ionchur na samhla
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": "..."}'
  • Uaslódálacha tacaithe: .jpg, .jpeg, .png, .webp (suas le 15 MB) agus .mp4, .mov, .webm (suas le 200 MB). Socraíonn an síneadh an cineál; caithfidh content_type teacht leis.
  • Bíonn an URL uaslódála bailí ar feadh uair an chloig. Fanann an file_url bailí.
  • Maidir le fuaim, úsáid URL poiblí nó URI sonraí.

Comhaid aschuir

Roghnaíonn tú cá fhad a choinnítear comhaid aschuir:

  • Go deo (permanent, an réamhshocrú): go dtí go scriosann tú iad, ar 100 creidmheasanna API ($0.10) in aghaidh GB in aghaidh na míosa, gearrtha uair sa lá ó iarmhéid API (1 GB = 1024³ beart).
  • 7 lá (temporary): saor in aisce, ansin scriosta ónár stóráil.

Socraigh an réamhshocrú leis an lasc "Coinnigh comhaid go deo" sa phainéal nó le PATCH /account/storage, agus sáraigh é in aghaidh an rith le ?storage=temporary (nó permanent):

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

Taispeánann gach iarratas a storage féin (mode, bytes, expires_at, expired). Baineann an socrú le hiarratais nua; fanann comhaid atá á gcoinneáil agat go deo go dtí go scriosann tú iad le DELETE /requests/{id}/files (féach Iarratais). Mura féidir le hiarmhéid API íoc as stóráil, seoltar ríomhphost chugat agus bíonn 30 lá agat le breisiú sula n-éiríonn na comhaid choimeádta sealadach.