Autentikasi

Buat kunci API dan kirimkan rahasia lengkap sebagai kredensial bearer. Rahasia hanya ditampilkan sekali.

Authorization: Bearer fd_live_xxx

Kirimkan tugas virtual try-on

Kirimkan gambar pakaian dan gambar model. Permintaan yang berhasil mengembalikan HTTP 202 beserta ID tugas.

curl -X POST \
  "https://www.fashiondiffusion.ai/api/public/v1/virtual-try-on/tasks" \
  -H "Authorization: Bearer fd_live_xxx" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "garmentImageUrl": "https://cdn.example.com/garment.jpg",
    "modelImageUrl": "https://cdn.example.com/model.jpg",
    "imageCount": 1,
    "resolution": "2K",
    "ratio": "3:4",
    "mode": "FAST",
    "prompt": "Keep the garment shape and fabric texture"
  }'

Kedua gambar harus berupa URL HTTPS publik, mengembalikan tipe konten gambar, serta berukuran tidak lebih dari 20 MB.

Setiap permintaan yang diterima akan membuat dan menagih tugas baru. Versi ini tidak memiliki perlindungan idempotensi, sehingga jangan secara otomatis mencoba kembali pengiriman yang gagal karena timeout kecuali biaya duplikat dapat diterima.

Tanyakan tugas

Gunakan ID tugas yang dikembalikan oleh endpoint submit. Kunci API hanya dapat membaca tugas yang dimiliki oleh pengguna dan tim saat ini.

curl \
  -H "Authorization: Bearer fd_live_xxx" \
  "https://www.fashiondiffusion.ai/api/public/v1/tasks/{taskId}"

Status tugas adalah QUEUED, RUNNING, SUCCEEDED, dan FAILED. URL gambar hasil yang berhasil dikembalikan dalam outputs.

Daftar tugas

Daftarkan tugas virtual try-on yang dikirimkan melalui API Publik oleh pengguna saat ini. Tugas yang dikirimkan dengan kunci API mana pun milik pengguna tersebut termasuk di dalam daftar.

curl \
  -H "Authorization: Bearer fd_live_xxx" \
  "https://www.fashiondiffusion.ai/api/public/v1/tasks?limit=20&createdAfter=2026-08-01T00%3A00%3A00Z"

limit menerima nilai 1 hingga 100 dan bawaannya adalah 20. Gunakan nextCursor sebagai cursor pada permintaan berikutnya. createdAfter adalah timestamp ISO 8601 opsional.

Kesalahan

Kesalahan menggunakan envelope yang konsisten. ID permintaan juga dikembalikan dalam header respons X-Request-Id.

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "garmentImageUrl: Invalid url",
    "requestId": "request-uuid"
  }
}