Langkau ke kandungan
Bahasa Melayu
Dapatkan kunci API
Panduan API

Fail

Lihat sebagai Markdown Dikemas kini

Model yang menerima imej, video atau audio menerimanya dalam salah satu daripada tiga bentuk. Setiap halaman model menandakan parameter failnya (contohnya image, images, videos, audios).

1. URL awam

Sebarang URL https:// (atau http://) yang boleh dimuat turun oleh model:

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

Fail mesti boleh dicapai tanpa kuki atau log masuk, dan kekal boleh dicapai sehingga permintaan bermula. Setiap halaman model menyenaraikan had saiz dan dimensi parameter failnya.

2. URI data

Fail kecil boleh disertakan sebaris sebagai URI data: sehingga 10 MB:

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

Base64 menjadikan isi kira-kira sepertiga lebih besar daripada fail, jadi utamakan muat naik untuk apa-apa yang besar.

3. Muat naik

Untuk fail tempatan, minta URL muat naik, lakukan PUT bait ke URL tersebut dan hantarkan file_url yang dikembalikan kepada model. Mencipta URL muat naik adalah percuma.

1 · Dapatkan URL muat naik
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 · muat naik
{
  "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 · Muat naik bait dengan tepat menggunakan pengepala yang dikembalikan
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
3 · Gunakan file_url sebagai input 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": "..."}'
  • Muat naik yang disokong: .jpg, .jpeg, .png, .webp (sehingga 15 MB) dan .mp4, .mov, .webm (sehingga 200 MB). Sambungan menentukan jenis; content_type mesti sepadan dengannya.
  • URL muat naik sah selama satu jam. file_url kekal sah.
  • Untuk audio, gunakan URL awam atau URI data.

Fail output

Anda boleh memilih tempoh fail output disimpan:

  • Selama-lamanya (permanent, lalai): sehingga anda memadamkannya, dengan harga 100 kredit API ($0.10) setiap GB sebulan, dicaj sekali sehari daripada baki API (1 GB = 1024³ bait).
  • 7 hari (temporary): percuma, kemudian dipadamkan daripada storan kami.

Tetapkan lalai dengan suis "Simpan fail selama-lamanya" dalam papan pemuka atau dengan PATCH /account/storage, dan gantikannya bagi setiap proses dengan ?storage=temporary (atau 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"}'

Setiap permintaan memaparkan storage sendiri (mode, bytes, expires_at, expired). Tetapan digunakan untuk permintaan baharu; fail yang telah anda simpan selama-lamanya kekal sehingga anda memadamkannya dengan DELETE /requests/{id}/files (lihat Permintaan). Jika baki API tidak dapat membayar storan, anda akan menerima e-mel dan mempunyai 30 hari untuk tambah nilai sebelum fail yang disimpan menjadi sementara.