Neidio i'r cynnwys
Cymraeg
Cael allwedd API
Canllaw API

Ffeiliau

Gweld fel Markdown Wedi'i ddiweddaru

Mae modelau sy’n derbyn delweddau, fideo neu sain yn eu derbyn ar unrhyw un o dair ffurf. Mae pob tudalen model yn nodi ei baramedrau ffeil (er enghraifft image, images, videos, audios).

1. URL cyhoeddus

Unrhyw URL https:// (neu http://) y gall y model ei lawrlwytho:

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

Rhaid i’r ffeil fod yn hygyrch heb gwcis na mewngofnodi, a pharhau’n hygyrch nes bod y cais wedi dechrau. Mae pob tudalen model yn rhestru terfynau maint a dimensiynau ei baramedrau ffeil.

2. URI data

Gall ffeiliau bach fynd yn fewnol fel URI data: o hyd at 10 MB:

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

Mae Base64 yn gwneud y corff tua thraean yn fwy na’r ffeil, felly mae’n well defnyddio uwchlwythiadau ar gyfer unrhyw beth mawr.

3. Uwchlwythiad

Ar gyfer ffeiliau lleol, gofynnwch am URL uwchlwytho, PUTiwch y bytes yno, a phasiwch y file_url a ddychwelwyd i’r model. Mae creu’r URL uwchlwytho am ddim.

1 · Cael URL uwchlwytho
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 · uwchlwytho
{
  "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 · Uwchlwytho’r bytes gyda’r union benynnau a ddychwelwyd
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
3 · Defnyddio file_url fel mewnbwn y model
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": "..."}'
  • Uwchlwythiadau a gefnogir: .jpg, .jpeg, .png, .webp (hyd at 15 MB) a .mp4, .mov, .webm (hyd at 200 MB). Mae’r estyniad yn gosod y math; rhaid i content_type gyd-fynd ag ef.
  • Mae’r URL uwchlwytho’n ddilys am awr. Mae’r file_url yn parhau’n ddilys.
  • Ar gyfer sain, defnyddiwch URL cyhoeddus neu URI data.

Ffeiliau allbwn

Chi sy’n dewis pa mor hir y cedwir ffeiliau allbwn:

  • Am byth (permanent, y rhagosodedig): tan i chi eu dileu, am 100 credydau API ($0.10) fesul GB y mis, wedi’u codi unwaith y dydd o falans yr API (1 GB = 1024³ bytes).
  • 7 diwrnod (temporary): am ddim, yna cânt eu dileu o’n storio.

Gosodwch y rhagosodiad gyda’r switsh "Cadw ffeiliau am byth" yn y dangosfwrdd neu gyda PATCH /account/storage, a’i ddiystyru fesul rhediad gyda ?storage=temporary (neu permanent):

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

Mae pob cais yn dangos ei storage ei hun (mode, bytes, expires_at, expired). Mae’r gosodiad yn berthnasol i geisiadau newydd; mae ffeiliau rydych eisoes yn eu cadw am byth yn aros nes i chi eu dileu gyda DELETE /requests/{id}/files (gweler Ceisiadau). Os na all balans yr API dalu am storio, cewch e-bost a 30 diwrnod i wneud ychwanegiad cyn i’r ffeiliau a gedwir ddod yn rhai dros dro.