Nexscope
Start free

IMPORTANT ASYNCHRONOUS TASK WORKFLOW

  1. Call this MCP generation tool once and read taskId from structuredContent.
  2. Do not call the generation tool again while the task is PENDING or RUNNING.
  3. Wait at least 5 seconds, then call nexscope_media_task_result with skillSlug set to smart-image-edit-manipulation-v3, the exact taskId, and the same bearer API key. While the task remains PENDING or RUNNING, use 5, 10, 20, and 30-second progressive backoff. Never query more often than once every 5 seconds.
  4. Stop querying when the task succeeds or fails. On success, return the final Nexscope resource URLs and the returned count as the actual charged credits.
  5. Never invent a taskId and never expose internal provider names or provider resource URLs.

Multimodal AI

Smart Image Edit & Manipulation API v3 MCP Tool

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. 1. Create onceCall the MCP tool once and keep the returned taskId.
  2. 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. 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

NameTypeRequiredMeaning
imageUrlstringrequired
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
promptstringrequired
Editing instruction.
Example: make the background pure white and keep the product unchanged
providerstringrequired
Image model.
Available options
  • BANANA
  • BANANA_2
  • BANANA_PRO
  • WAN2_7
  • QWEN_IMAGE_3_PRO
  • SEEDREAM5
  • GPT_2_IMAGE
  • AIDRAW_EDIT
Example: BANANA_PRO
outputNumintegeroptional
Number of images to generate, from 1 to 4.
Example: 1
resolutionstringoptional
Target resolution preset.
Example: 1K
aspectRatiostringoptional
Target aspect ratio.
Example: 1:1
supplyTypestringoptional
Generation route. Defaults to stable.
Available options
  • eco
  • stable
Example: stable
needOptimizebooleanoptional
Whether the prompt should be optimized upstream.
Example: true
templatestringoptional
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
sourcestringoptional
Optional traffic or product source code.
Example: api
qualitystringoptional
GPT Image quality only. Defaults to medium.
Available options
  • low
  • medium
  • high
Example: medium

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredDescription
dataanyrequired
Data value used by this API operation.
codeintegerrequired
0 means accepted or successful; nonzero is a platform error.
msgstring | nullrequired
Msg value used by this API operation.
tsstringrequired
Epoch milliseconds.
timestringrequired
Server local time: yyyy-MM-dd HH:mm:ss.
coststringrequired
Elapsed milliseconds, never credits; -1 outside web requests.
traceIdstring | nullrequired
Trace id value used by this API operation.

Any of option 1 — requires taskId, status, result

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.taskIdstringrequired
Task id value used by this API operation.
data.statusstringrequired
Status value used by this API operation.
Allowed: PENDING, RUNNING, SUCCEEDED, FAILED, TIMEOUT
data.resultanyrequired
Result value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.resultobjectrequired
Completed generation output retained from the task result. Fields vary by capability; generated resources use Nexscope-hosted URLs and any count represents charged Nexscope credits. This is the business output, not a task creation receipt.

Any of option 2

NameTypeRequiredDescription
data.resultnullrequired
Result value used by this API operation.

Any of option 2

NameTypeRequiredDescription
datanullrequired
Data value used by this API operation.

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
}