認証

APIキーを作成し、完全なシークレットをBearer認証情報として送信します。シークレットは一度だけ表示されます。

Authorization: Bearer fd_live_xxx

バーチャル試着タスクを送信

服装画像とモデル画像を送信します。成功すると、タスクIDを含むHTTP 202レスポンスが返されます。

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

両方の画像は公開HTTPS URLで、画像のContent-Typeを返し、20 MB以下である必要があります。

受理されたリクエストごとに新しいタスクが作成され、クレジットが消費されます。このバージョンには冪等性保護がないため、重複課金を許容できない場合はタイムアウトした送信を自動再試行しないでください。

タスクを照会

送信エンドポイントから返されたタスクIDを使用します。APIキーは、そのユーザーと現在のチームが所有するタスクのみ読み取れます。

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

タスクのステータスはQUEUED、RUNNING、SUCCEEDED、FAILEDです。成功した出力画像URLはoutputsに返されます。

タスク一覧

現在のユーザーがPublic APIから送信したバーチャル試着タスクを一覧表示します。ユーザーが所有するすべてのAPIキーから送信されたタスクが含まれます。

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

limitは1から100で、デフォルトは20です。次のリクエストではnextCursorをcursorとして指定します。createdAfterには任意のISO 8601日時を指定できます。

エラー

エラーは共通形式で返されます。リクエストIDはX-Request-Idレスポンスヘッダーにも含まれます。

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