Multimodal AI
Smart Image Edit & Manipulation API v3 MCP
Perform general image editing with prompt, resolution, aspect ratio, and quality controls. Call it via REST API or MCP, or try it in the online playground.
Smart Image Edit & Manipulation API v3 AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Edit A Product Image
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain.
2. Create Several Alternatives
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Create [number of outputs within this tool’s supported limit] for review, keeping the same source material and brief.
3. Fit The Output To A Placement
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use [supported resolution] and [supported aspect ratio] for my target placement. Check compatibility with the selected image model.
4. Choose GPT Image Quality
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. When using the supported GPT Image provider, use [low, medium or high quality]. Do not apply this provider-specific option to other models.
5. Choose The Editing Route
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use [economy or stable generation] and choose whether to refine my editing instruction before processing. Preserve my intended change.
6. Apply The White Background Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the white background template for this edit, with my supplied material and directions. Review the result before using it publicly.
7. Apply The Product Main Image Retouching Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the product main image retouching template for this edit, with my supplied material and directions. Review the result before using it publicly.
8. Apply The Scene Generation Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the scene generation template for this edit, with my supplied material and directions. Review the result before using it publicly.
9. Apply The Poster Design Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the poster design template for this edit, with my supplied material and directions. Review the result before using it publicly.
10. Apply The Add Person Or Object Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the add person or object template for this edit, with my supplied material and directions. Review the result before using it publicly.
11. Apply The Change Animal Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the change animal template for this edit, with my supplied material and directions. Review the result before using it publicly.
12. Apply The Flat Lay Apparel Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the flat lay apparel template for this edit, with my supplied material and directions. Review the result before using it publicly.
13. Apply The 3D Apparel Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the 3d apparel template for this edit, with my supplied material and directions. Review the result before using it publicly.
14. Apply The Mannequin To Model Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the mannequin to model template for this edit, with my supplied material and directions. Review the result before using it publicly.
15. Apply The Cartoon Illustration Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the cartoon illustration template for this edit, with my supplied material and directions. Review the result before using it publicly.
16. Apply The Body Reshape Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the body reshape template for this edit, with my supplied material and directions. Review the result before using it publicly.
17. Apply The Change Style Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the change style template for this edit, with my supplied material and directions. Review the result before using it publicly.
18. Apply The Remove Element Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the remove element template for this edit, with my supplied material and directions. Review the result before using it publicly.
19. Apply The Remove Text Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the remove text template for this edit, with my supplied material and directions. Review the result before using it publicly.
20. Apply The Remove Watermark Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the remove watermark template for this edit, with my supplied material and directions. Review the result before using it publicly.
21. Apply The Add Watermark Edit
Prompt: Edit [image] according to [editing brief] using [supported image model]. Preserve product facts and the parts I ask to retain. Use the add watermark template for this edit, with my supplied material and directions. Review the result before using it publicly.
What You Need to Provide
Provide assets you may use and that meet this tool’s documented file, dimension and count limits.
A pending task is not a completed image, video or text result. Retrieve the existing task rather than submitting a duplicate.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_smart_image_edit_manipulation_v3https://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "smart-image-edit-manipulation-v3-1",
"method": "tools/call",
"params": {
"name": "nexscope_smart_image_edit_manipulation_v3",
"arguments": {
"aspectRatio": "1:1",
"imageUrl": "https://example.com/product.jpg",
"needOptimize": true,
"outputNum": 1,
"prompt": "make the background pure white and keep the product unchanged",
"provider": "BANANA_PRO",
"quality": "medium",
"resolution": "1K",
"source": "api",
"supplyType": "stable",
"template": "white-background"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Asynchronous task workflow
- 1. Create once
Keep the returned taskId.
- 2. Query with backoff
Use nexscope_media_task_result after 5 seconds, then 10, 20, and 30 seconds.
- 3. Use final result
Stop at success, failure, or timeout.
{
"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"
}
}
}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
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
Example: stable |
needOptimize | boolean | optional | Whether the prompt should be optimized upstream. Example: true |
template | string | optional | Optional Nexscope editing template. Available options
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
Example: medium |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
data | any | required | Data value used by this API operation. |
msg | string | null | required | Msg value used by this API operation. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
traceId | string | null | required | Trace id value used by this API operation. |
ts | string | required | Epoch milliseconds. |
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 | 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. |
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
| Name | Type | Required | Description |
|---|---|---|---|
data.result | object | required | 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
| Name | Type | Required | Description |
|---|---|---|---|
data.result | null | required | 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
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
Use Smart Image Edit & Manipulation with the supplied reference material for this brief: make the background pure white and keep the product unchanged
Illustrative Response Explanation
The illustrative request has been accepted as task example-task and is PENDING. No completed output is available yet. Keep this task ID and check its result; do not submit the same request again just because processing has not finished.
About this sample: Illustrative format example with fictional values, not a live tool call. Replace example inputs with your own permitted assets or public identifiers.
Published sample data is not available for this page. A format illustration or workflow guide is not a substitute for a published result.
View the MCP Request & Response Format
Examples
Illustrative example with fictional data, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "smart-image-edit-manipulation-v3-example",
"method": "tools/call",
"params": {
"name": "nexscope_smart_image_edit_manipulation_v3",
"arguments": {
"aspectRatio": "1:1",
"imageUrl": "https://example.com/product.jpg",
"needOptimize": true,
"outputNum": 1,
"prompt": "make the background pure white and keep the product unchanged",
"provider": "BANANA_PRO",
"resolution": "1K",
"source": "api",
"supplyType": "stable",
"template": "white-background"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "smart-image-edit-manipulation-v3-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"cost\":\"-1\",\"data\":{\"taskId\":\"example-task\",\"status\":\"PENDING\",\"result\":null},\"msg\":null,\"time\":\"2026-01-01 00:00:00\",\"traceId\":null,\"ts\":\"0\"}"
}
],
"structuredContent": {
"code": 0,
"cost": "-1",
"data": {
"taskId": "example-task",
"status": "PENDING",
"result": null
},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
},
"isError": false
}
}