Multimodal AI

Smart Image Edit & Manipulation API v3

Perform general image editing with provider, prompt, resolution, aspect ratio, and quality controls.

post/api/skill-api/v1/skills/smart-image-edit-manipulation-v3/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/smart-image-edit-manipulation-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

imageUrlstring required

Public URL of the image to edit. The image must be between 300 and 4096 pixels in both width and height, and its width-to-height ratio must be between 0.4 and 2.5.

promptstring required

Editing instruction.

providerstring required

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

outputNuminteger

Number of images to generate, from 1 to 4.

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 Nexscope editing template. Supported values: white-background, product-main-image-retouching, scene-generation, poster-design, add-person-or-object, change-animal, flat-lay-apparel, 3d-apparel, mannequin-to-model, cartoon-illustration, body-reshape, change-style, remove-element, remove-text, remove-watermark, add-watermark.

sourcestring

Optional traffic or product source code.

qualitystring

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

Example request

{
  "imageUrl": "https://example.com/product.jpg",
  "prompt": "make the background pure white and keep the product unchanged",
  "provider": "BANANA_PRO",
  "outputNum": 1,
  "resolution": "1K",
  "aspectRatio": "1:1",
  "supplyType": "stable",
  "needOptimize": true,
  "template": "white-background",
  "source": "api",
  "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.