Xác thực

Tạo một khóa API và gửi toàn bộ giá trị bí mật dưới dạng chứng thực bearer. Giá trị bí mật chỉ được hiển thị duy nhất một lần.

Authorization: Bearer fd_live_xxx

Gửi một tác vụ thử đồ ảo

Gửi ảnh sản phẩm thời trang và ảnh người mẫu. Yêu cầu thành công sẽ trả về mã trạng thái HTTP 202 cùng với ID của tác vụ.

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"
  }'

# Use Base64 instead of URL fields; each image accepts exactly one input form
"garmentImageBase64": "data:image/jpeg;base64,/9j/4AAQSk...",
"modelImageBase64": "data:image/png;base64,iVBORw0KGgo..."

Mỗi ảnh có thể là URL HTTPS công khai hoặc URL dữ liệu Base64. Các ảnh định dạng JPEG, PNG và WebP không được vượt quá 20 MB; API lưu trữ đầu vào trước khi tạo tác vụ.

Mỗi yêu cầu được chấp nhận sẽ tạo và tính phí cho một tác vụ mới. Phiên bản này không hỗ trợ bảo vệ chống trùng lặp (idempotency), do đó bạn không nên tự động thử lại yêu cầu bị hết thời gian chờ (timeout) trừ khi việc tính phí kép là điều có thể chấp nhận được.

Truy vấn một tác vụ

Sử dụng ID tác vụ được trả về bởi endpoint gửi yêu cầu. Một khóa API chỉ có thể đọc các tác vụ thuộc sở hữu của người dùng và nhóm hiện tại liên kết với khóa đó.

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

Các trạng thái tác vụ bao gồm: QUEUED, RUNNING, SUCCEEDED và FAILED. Các URL ảnh đầu ra thành công được trả về trong trường outputs.

Danh sách các tác vụ

Liệt kê các tác vụ thử đồ ảo được gửi qua API công khai bởi người dùng hiện tại. Các tác vụ được gửi bằng bất kỳ khóa API nào của người dùng đều được bao gồm.

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

Giá trị limit chấp nhận từ 1 đến 100 và mặc định là 20. Sử dụng nextCursor làm giá trị cursor cho yêu cầu tiếp theo. createdAfter là dấu thời gian tùy chọn theo chuẩn ISO 8601.

Lỗi

Các lỗi sử dụng cấu trúc bao ngoài (envelope) thống nhất. ID yêu cầu cũng được trả về trong tiêu đề phản hồi X-Request-Id.

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