Uploads

POST/v1/uploads

Uploads one product photo as multipart/form-data, in a field named file: PNG, JPEG or WebP up to 10 MB. It is saved to your image library on fittins.ai (it counts toward storage) and can be used in any number of generations as { "upload_id": "upl_…" }. Photos sent by URL are copied to the library the same way.

curl

curl https://api.fittins.ai/v1/uploads \
  -H "Authorization: Bearer $FITTINS_API_KEY" \
  -F "file=@tshirt-red-front.jpg"

201 Created

{
  "id": "upl_1793816500123_5Tn8Rr2W",
  "object": "upload",
  "filename": "tshirt-red-front.jpg",
  "content_type": "image/jpeg",
  "size_bytes": 842113,
  "width": 1024,
  "height": 1024,
  "created_at": "2026-11-04T17:01:40.000Z"
}

Questions? Email support@fittins.ai with the X-Request-Id of the request.Next: Files →