IMPORTANT ASYNCHRONOUS TASK WORKFLOW
- Call this MCP generation tool once and read taskId from structuredContent.
- Do not call the generation tool again while the task is PENDING or RUNNING.
- Wait at least 5 seconds, then call nexscope_media_task_result with skillSlug set to ai-apparel-image-set-photography-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.
- 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.
- Never invent a taskId and never expose internal provider names or provider resource URLs.
Multimodal AI
AI Apparel Image Set & Photography API v3 MCP Tool
Create apparel ecommerce image sets from clothing images with optional model and scene references.
MCP tool name
nexscope_ai_apparel_image_set_photography_v3Legacy MCP endpoint
/api/skill-api/v1/mcpJSON-RPC method
tools/callAuthentication
Send the user API key as a bearer token on every MCP JSON-RPC request.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxIf 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": "ai-apparel-image-set-photography-v3-1",
"method": "tools/call",
"params": {
"name": "nexscope_ai_apparel_image_set_photography_v3",
"arguments": {
"imageList": [
"https://example.com/product.jpg"
],
"provider": "BANANA_2",
"sellerPoint": "Lightweight breathable summer dress",
"isExtractPrePoint": false,
"resolution": "2K",
"aspectRatio": "1:1",
"noText": false,
"brandKey": "{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}",
"quality": "medium",
"sensitiveLibraryId": 1001,
"replaceLibraryId": 1002,
"modelImageUrl": "https://example.com/model-reference.jpg",
"sceneImageUrl": "https://example.com/scene.jpg",
"isExactScene": true,
"modelAndSceneInfo": "{\"model\":\"female adult\",\"scene\":\"studio\"}",
"aPlusNum": 0,
"aPlusProNum": 0,
"aPlusHasPhone": false,
"aPlusAspectRatio": "1:1",
"modelTypeNum": 0,
"insTypeNum": 0,
"sellerTypeNum": 0,
"sizeTypeNum": 0,
"whiteTypeNum": 0,
"aPlusStyles": [
{
"id": 1
},
{
"prompt": "clean editorial layout"
}
],
"pointStyles": [
{
"id": 2
},
{
"prompt": "minimal feature callouts"
}
]
}
}
}Legacy endpoint
POST /api/skill-api/v1/mcpCanonical detail URL
https://www.nexscope.ai/mcp-map/ai-apparel-image-set-photography-v3Asynchronous 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_resultwith 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": "ai-apparel-image-set-photography-v3-result-1",
"method": "tools/call",
"params": {
"name": "nexscope_media_task_result",
"arguments": {
"skillSlug": "ai-apparel-image-set-photography-v3",
"taskId": "TASK_ID_FROM_THE_GENERATION_RESULT"
}
}
}REST fallback
GET https://api.nexscope.ai/api/skill-api/v1/skills/ai-apparel-image-set-photography-v3/tasks/{taskId}Arguments
| Name | Type | Required | Meaning |
|---|---|---|---|
imageList | array | required | Public apparel image URLs. Provide no more than 5 JPG, JPEG, PNG, or WEBP images; each image must be at most 10 MB and between 384 and 4096 pixels. Example: [
"https://example.com/product.jpg"
] |
provider | string | optional | Image model. Defaults to BANANA_2. Available options
Example: BANANA_2 |
sellerPoint | string | optional | Product selling points, up to 2500 characters. Required when isExtractPrePoint is false. Example: Lightweight breathable summer dress |
isExtractPrePoint | boolean | optional | Whether to automatically extract selling points. Defaults to false. When false, sellerPoint is required. Example: false |
resolution | string | optional | Target resolution supported by the selected provider. Example: 2K |
aspectRatio | string | optional | Target aspect ratio. Example: 1:1 |
noText | boolean | optional | Whether generated images should avoid text. Example: false |
brandKey | string | optional | Optional brand information serialized as a JSON string. Supported keys: brandColor, fontStyle, salesRegion, language, platform, customSettings. Example: {"brandColor":"#0775FA","fontStyle":"sans serif","salesRegion":"North America","language":"English","platform":"Amazon"} |
quality | string | optional | GPT Image quality only. Available options
Example: medium |
sensitiveLibraryId | integer | optional | Optional sensitive-word library ID used to screen generated copy. Example: 1001 |
replaceLibraryId | integer | optional | Optional replacement-word library ID used to rewrite generated copy. Example: 1002 |
modelImageUrl | string | optional | Optional model reference image URL. Example: https://example.com/model-reference.jpg |
sceneImageUrl | string | optional | Optional scene reference image URL. Example: https://example.com/scene.jpg |
isExactScene | boolean | optional | Whether to match the provided scene closely. Defaults to true. Example: true |
modelAndSceneInfo | string | optional | Model and scene information serialized as a JSON string or concise structured text. Example: {"model":"female adult","scene":"studio"} |
aPlusNum | integer | optional | Number of standard A+ images, from 0 to 12. Defaults to 0. Example: 0 |
aPlusProNum | integer | optional | Number of premium A+ images, from 0 to 12. Defaults to 0. Example: 0 |
aPlusHasPhone | boolean | optional | Whether A+ output includes phone display layouts. Example: false |
aPlusAspectRatio | string | optional | A+ output aspect ratio. Available options
Example: 1:1 |
modelTypeNum | integer | optional | Number of model images, from 0 to 12. Defaults to 0. Example: 0 |
insTypeNum | integer | optional | Number of social-style images, from 0 to 12. Defaults to 0. Example: 0 |
sellerTypeNum | integer | optional | Number of selling-point images, from 0 to 12. Defaults to 0. Example: 0 |
sizeTypeNum | integer | optional | Number of size-information images, from 0 to 12. Defaults to 0. Example: 0 |
whiteTypeNum | integer | optional | Number of white-background images, from 0 to 12. Defaults to 0. Example: 0 |
aPlusStyles | array | optional | Optional A+ style entries. Each item may contain a saved style id or a custom prompt. Example: [
{
"id": 1
},
{
"prompt": "clean editorial layout"
}
] |
pointStyles | array | optional | Optional selling-point style entries. Each item may contain a saved style id or a custom prompt. Example: [
{
"id": 2
},
{
"prompt": "minimal feature callouts"
}
] |
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.taskId | string | required | Task id value used by this API operation. |
data.status | string | required | Status value used by this API operation. Allowed: PENDING, RUNNING, SUCCEEDED, FAILED, TIMEOUT |
data.result | any | required | Result 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 | Result value used by this API operation. |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Examples
Example arguments
{
"imageList": [
"https://example.com/product.jpg"
],
"provider": "BANANA_2",
"sellerPoint": "Lightweight breathable summer dress",
"isExtractPrePoint": false,
"resolution": "2K",
"aspectRatio": "1:1",
"noText": false,
"brandKey": "{\"brandColor\":\"#0775FA\",\"fontStyle\":\"sans serif\",\"salesRegion\":\"North America\",\"language\":\"English\",\"platform\":\"Amazon\"}",
"quality": "medium",
"sensitiveLibraryId": 1001,
"replaceLibraryId": 1002,
"modelImageUrl": "https://example.com/model-reference.jpg",
"sceneImageUrl": "https://example.com/scene.jpg",
"isExactScene": true,
"modelAndSceneInfo": "{\"model\":\"female adult\",\"scene\":\"studio\"}",
"aPlusNum": 0,
"aPlusProNum": 0,
"aPlusHasPhone": false,
"aPlusAspectRatio": "1:1",
"modelTypeNum": 0,
"insTypeNum": 0,
"sellerTypeNum": 0,
"sizeTypeNum": 0,
"whiteTypeNum": 0,
"aPlusStyles": [
{
"id": 1
},
{
"prompt": "clean editorial layout"
}
],
"pointStyles": [
{
"id": 2
},
{
"prompt": "minimal feature callouts"
}
]
}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
}