Skip to main content
Call POST /images/preview to upload a clothing photo and run it through the Drssed image pipeline. The API removes the background from the image and uses AI to detect the item’s dominant color, category, relevant seasons, and style tags. The returned image_id links the processed image to a clothing item when you call POST /users/me/clothing.

​
Endpoint

​
Request parameters

​
file
file
required
The clothing image to process. Send as a multipart/form-data field.

​
Response fields

Status: 201 Created
​
image_url
string
required
URL of the processed image with the background removed.
​
image_id
string
required
Unique identifier for this processed image. Pass this as image_id when creating a clothing item via POST /users/me/clothing.
​
image_color
string
required
Detected dominant color of the clothing item.
​
image_category
string
required
Detected category of the clothing item. One of: JACKET, TOP, BOTTOM, FOOTWEAR.
​
image_seasons
array
required
Detected seasons the item is suited for. Possible values: Spring, Summer, Autumn, Winter.
​
image_tags
array
required
Detected style tags for the item. Possible values: Casual, Formal, Sports, Vintage.

​
Error codes

​
Example

cURL
Response
This endpoint is strictly rate limited to 1 request per minute. Queue image uploads appropriately to avoid hitting the limit.
Use the returned image_category, image_seasons, and image_tags as default values when calling POST /users/me/clothing — this reduces the amount of input the user needs to provide.