Multimodal AI

AI Apparel Image Set & Photography API v3

Create apparel ecommerce image sets from clothing images with optional model and scene references.

post/api/skill-api/v1/skills/ai-apparel-image-set-photography-v3/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/ai-apparel-image-set-photography-v3/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

imageListstring[] required

Public apparel image URLs. Provide no more than 5 JPG, JPEG, PNG, or WEBP images; each image must be at most 10 MB and between 384 and 4096 pixels.

providerstring

Image model. Defaults to BANANA_2. Supported values: BANANA_2, BANANA_2_LITE, BANANA_PRO, WAN2_7, SEEDREAM5_PRO, GPT_2_IMAGE.

sellerPointstring

Product selling points, up to 2500 characters. Required when isExtractPrePoint is false.

isExtractPrePointboolean

Whether to automatically extract selling points. Defaults to false. When false, sellerPoint is required.

resolutionstring

Target resolution supported by the selected provider.

aspectRatiostring

Target aspect ratio.

noTextboolean

Whether generated images should avoid text.

brandKeystring

Optional brand information serialized as a JSON string. Supported keys: brandColor, fontStyle, salesRegion, language, platform, customSettings.

qualitystring

GPT Image quality only. Supported values: low, medium, or high.

sensitiveLibraryIdinteger

Optional sensitive-word library ID used to screen generated copy.

replaceLibraryIdinteger

Optional replacement-word library ID used to rewrite generated copy.

modelImageUrlstring

Optional model reference image URL.

sceneImageUrlstring

Optional scene reference image URL.

isExactSceneboolean

Whether to match the provided scene closely. Defaults to true.

modelAndSceneInfostring

Model and scene information serialized as a JSON string or concise structured text.

aPlusNuminteger

Number of standard A+ images, from 0 to 12. Defaults to 0.

aPlusProNuminteger

Number of premium A+ images, from 0 to 12. Defaults to 0.

aPlusHasPhoneboolean

Whether A+ output includes phone display layouts.

aPlusAspectRatiostring

A+ output aspect ratio. Supported values: 16:9, 9:16, 1:1, 1:3.7.

modelTypeNuminteger

Number of model images, from 0 to 12. Defaults to 0.

insTypeNuminteger

Number of social-style images, from 0 to 12. Defaults to 0.

sellerTypeNuminteger

Number of selling-point images, from 0 to 12. Defaults to 0.

sizeTypeNuminteger

Number of size-information images, from 0 to 12. Defaults to 0.

whiteTypeNuminteger

Number of white-background images, from 0 to 12. Defaults to 0.

Example request

{
  "imageList": [
    "https://example.com/product.jpg"
  ],
  "provider": "BANANA_2",
  "sellerPoint": "Lightweight breathable summer dress",
  "isExtractPrePoint": false,
  "resolution": "2K",
  "aspectRatio": "1:1",
  "noText": false,
  "brandKey": "{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}",
  "quality": "medium",
  "sensitiveLibraryId": 1001,
  "replaceLibraryId": 1002,
  "modelImageUrl": "https://example.com/model-reference.jpg",
  "sceneImageUrl": "https://example.com/scene.jpg",
  "isExactScene": true,
  "modelAndSceneInfo": "{\"model\":\"female adult\",\"scene\":\"studio\"}",
  "aPlusNum": 0,
  "aPlusProNum": 0,
  "aPlusHasPhone": false,
  "aPlusAspectRatio": "1:1",
  "modelTypeNum": 0,
  "insTypeNum": 0,
  "sellerTypeNum": 0,
  "sizeTypeNum": 0,
  "whiteTypeNum": 0,
  "aPlusStyles": [
    {
      "id": 1
    },
    {
      "prompt": "clean editorial layout"
    }
  ],
  "pointStyles": [
    {
      "id": 2
    },
    {
      "prompt": "minimal feature callouts"
    }
  ]
}

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.