Multimodal AI

Smart Multi-Image Editing API v3

Create an edited output from multiple source images using prompt, provider, resolution, and quality controls.

post/api/skill-api/v1/skills/smart-multi-image-editing-v3/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/smart-multi-image-editing-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 image URLs to combine or reference. Provide no more than 6 JPG, JPEG, PNG, or WEBP images; each image must be at most 10 MB and between 800 and 4096 pixels.

providerstring required

Image model. Supported values: BANANA, BANANA_2, BANANA_PRO, WAN2_7, QWEN_IMAGE_3_PRO, SEEDREAM5, GPT_2_IMAGE, or AIDRAW_EDIT.

promptstring

Optional fusion instruction, up to 600 characters.

outputNuminteger

Number of images to generate. Defaults to 1.

resolutionstring

Target resolution preset.

aspectRatiostring

Target aspect ratio.

supplyTypestring

Generation route. Supported values: eco or stable. Defaults to stable.

needOptimizeboolean

Whether the prompt should be optimized upstream.

templatestring

Optional fusion template. Supported values: outfit-fusion, outfit-try-on.

qualitystring

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

Example request

{
  "imageList": [
    "https://example.com/product.jpg",
    "https://example.com/model-reference.jpg"
  ],
  "provider": "BANANA_PRO",
  "prompt": "combine the product with the model in a clean studio scene",
  "outputNum": 1,
  "resolution": "1K",
  "aspectRatio": "1:1",
  "supplyType": "stable",
  "needOptimize": true,
  "template": "outfit-fusion",
  "quality": "medium"
}

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.