POST/vton/upload

Upload VTON Images

Upload image files (person profiles, garment photos) to obtain the public cloud URLs required for triggering the try-on generator.

Authentication: Required (X-API-Key)

Content-Type: multipart/form-data

Request Parameters

Field	Type	Required	Default	Description
files	List[Binary]	Yes	`—`	1 to 4 image files to upload. Supports JPEG, PNG, WEBP.
userId	string	Yes	`—`	The user ID associated with the API key owner.
resolution	integer	No	`1000`	Target resolution limit. Default is 1000 (auto-resize/optimize).

curl -X POST "https://apisdk.snapmydesign.com/api/v1/vton/upload" \
  -H "X-API-Key: smd_live_your_key_here" \
  -F "files=@/path/to/tshirt.png" \
  -F "userId=user_abc123"

Example Response200 OK

{
  "success": true,
  "statusCode": 200,
  "message": "Upload successful",
  "uploaded": [
    {
      "id": "e4a2d8b5-908c-4a34-be57-410a0e954a1a",
      "url": "https://firebasestorage.googleapis.com/v0/b/xdesign-d72cd.appspot.com/o/vton_uploaded_image..."
    }
  ]
}