Multimodal AI

AI Clothes Changer API for Tops & Bottoms

Dress a model image with upper and/or lower garment assets, supporting optional masks and original garment references.

post/api/skill-api/v1/skills/ai-clothes-changer-for-tops-bottoms/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/ai-clothes-changer-for-tops-bottoms/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

modelImageUrlstring required

Public URL of the model image.

upperOriginUrlstring

Public URL of the original upper garment image. The image must be up to 20 MB and between 385 and 4096 pixels in both width and height.

downOriginUrlstring

Public URL of the original lower garment image. The image must be up to 20 MB and between 385 and 4096 pixels in both width and height.

upperImageUrlstring

Optional processed upper garment mask or crop URL.

downImageUrlstring

Optional processed lower garment mask or crop URL.

modelMaskImageUrlstring

Optional mask URL for the model body area.

outputNuminteger

Number of images to generate, from 1 to 4. Defaults to 1.

Example request

{
  "modelImageUrl": "https://example.com/model-reference.jpg",
  "upperOriginUrl": "https://example.com/top.jpg",
  "downOriginUrl": "https://example.com/bottom.jpg",
  "upperImageUrl": "https://example.com/top-mask.png",
  "downImageUrl": "https://example.com/bottom-mask.png",
  "modelMaskImageUrl": "https://example.com/mask.png",
  "outputNum": 1
}

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.