Back to MCP Guide

Multimodal AI

Smart Image Edit & Manipulation API v3

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

MCP tool name

nexscope_smart_image_edit_manipulation_v3

Legacy MCP endpoint

/api/skill-api/v1/mcp

JSON-RPC method

tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "smart-image-edit-manipulation-v3-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_smart_image_edit_manipulation_v3",
    "arguments": {
      "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"
    }
  }
}

Legacy endpoint

POST /api/skill-api/v1/mcp

Canonical detail URL

https://www.nexscope.ai/mcp-map/smart-image-edit-manipulation-v3

Asynchronous task workflow

This capability uses a create-and-query flow. Creating the task and retrieving its final generated resources are two connected requests.

1. Create onceCall the MCP tool once and keep the returned taskId.
2. Query with backoffCall nexscope_media_task_result with this skill slug and task ID. Wait at least 5 seconds first; while pending or running, back off at 5, 10, 20, then 30-second intervals.
3. Use final resultStop at a terminal status. Successful results contain Nexscope resource URLs and the actual charged-credit count.

MCP task result call

{
  "jsonrpc": "2.0",
  "id": "smart-image-edit-manipulation-v3-result-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_media_task_result",
    "arguments": {
      "skillSlug": "smart-image-edit-manipulation-v3",
      "taskId": "TASK_ID_FROM_THE_GENERATION_RESULT"
    }
  }
}

REST fallback

GET https://api.nexscope.ai/api/skill-api/v1/skills/smart-image-edit-manipulation-v3/tasks/{taskId}

Arguments

Name	Type	Required	Description
`imageUrl`	`string`	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. Example: https://example.com/product.jpg
`prompt`	`string`	required	Editing instruction. Example: make the background pure white and keep the product unchanged
`provider`	`string`	required	Image model. Available options `BANANA` `BANANA_2` `BANANA_PRO` `WAN2_7` `QWEN_IMAGE_3_PRO` `SEEDREAM5` `GPT_2_IMAGE` `AIDRAW_EDIT` Example: BANANA_PRO
`outputNum`	`integer`	optional	Number of images to generate, from 1 to 4. Example: 1
`resolution`	`string`	optional	Target resolution preset. Example: 1K
`aspectRatio`	`string`	optional	Target aspect ratio. Example: 1:1
`supplyType`	`string`	optional	Generation route. Defaults to stable. Available options `eco` `stable` Example: stable
`needOptimize`	`boolean`	optional	Whether the prompt should be optimized upstream. Example: true
`template`	`string`	optional	Optional Nexscope editing template. Available options `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` Example: white-background
`source`	`string`	optional	Optional traffic or product source code. Example: api
`quality`	`string`	optional	GPT Image quality only. Defaults to medium. Available options `low` `medium` `high` Example: medium

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`data`	`any`	required	Data value used by this API operation.
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`msg`	`string \| null`	required	Msg value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`cost`	`string`	required	Elapsed milliseconds, never credits; -1 outside web requests.
`traceId`	`string \| null`	required	Trace id value used by this API operation.

Any of option 1 — requires taskId, status, result

Name	Type	Required	Description
`data`	`object`	required	Data value used by this API operation.
`data.result`	`any`	required	Result value used by this API operation.
`data.status`	`string`	required	Status value used by this API operation. Allowed: PENDING, RUNNING, SUCCEEDED, FAILED, TIMEOUT
`data.taskId`	`string`	required	Task id value used by this API operation.

Any of option 1

Examples

Example arguments

{
  "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"
}

Example structuredContent

{
  "data": {
    "taskId": "example-task",
    "status": "PENDING",
    "result": null
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}

Smart Image Edit & Manipulation API v3

Smart Image Edit & Manipulation API v3

Authentication

Call this MCP tool

Asynchronous task workflow

Arguments

Response fields

Any of option 1 — requires taskId, status, result

Any of option 1

Examples

Example arguments

Example structuredContent

Any of option 2

Any of option 2

IMPORTANT ASYNCHRONOUS TASK WORKFLOW

Smart Image Edit & Manipulation API v3

IMPORTANT ASYNCHRONOUS TASK WORKFLOW

Smart Image Edit & Manipulation API v3

Authentication

Call this MCP tool

Asynchronous task workflow

Arguments

Response fields

Any of option 1 — requires taskId, status, result

Any of option 1

Examples

Example arguments

Example structuredContent

Related MCP tools

Any of option 2

Any of option 2