openapi: 3.2.0 info: title: Nexscope Ecommerce Data and Creative Multimodal AI API version: 2026-08-28-public-catalog-v1 description: Nexscope APIs provide ecommerce marketplace intelligence and creative generation capabilities through REST and MCP. Authentication uses a Nexscope API key. Pricing is credit-based and actual usage varies by endpoint and workload; current estimates are shown in the Nexscope account. termsOfService: https://www.nexscope.ai/terms contact: name: Nexscope Support email: service@nexscope.ai url: https://www.nexscope.ai/api-docs license: name: Proprietary API; use subject to Nexscope Terms url: https://www.nexscope.ai/terms servers: - url: https://api.nexscope.ai description: Production security: - bearerAuth: [] tags: - name: Multimodal AI description: Image recognition, image editing, image generation, and ecommerce creative APIs. x-category-slug: multimodal-ai paths: /api/skill-api/v1/skills/ai-model-swap/run: post: tags: - Multimodal AI summary: AI Model Swap API description: Generate model images by combining a source product image with a model head image, optional masks, scene references, and prompt guidance. operationId: runAiModelSwap externalDocs: description: AI Model Swap API documentation url: https://www.nexscope.ai/api-docs/ai-model-swap requestBody: required: true content: application/json: schema: type: object description: Generate model images by combining a source product image with a model head image, optional masks, scene references, and prompt guidance. properties: imageUrl: type: string description: Public URL of the source product or outfit image. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height. example: https://example.com/source-image.jpg modelHeadImageUrl: type: string description: Public URL of the target model head image. The image must be up to 5 MB and between 512 and 2048 pixels in both width and height. example: https://example.com/model-reference.jpg imageSegUrl: type: string description: Optional segmentation mask URL for the source image. example: https://example.com/mask.png sceneImgUrl: type: string description: Optional scene reference image URL. The image must be up to 10 MB and between 768 and 4096 pixels in both width and height. example: https://example.com/scene.jpg sceneStrength: type: number description: Scene reference strength from 0 to 1. Defaults to 0.7. example: 0.7 modelPrompt: type: string description: Comma-separated model appearance terms, such as smile, laugh, sitting, lying, fat, plump, slim, sideways, profile, back, or bald. example: smile, slim customPrompt: type: string description: Positive generation prompt, up to 600 characters. example: clean ecommerce catalog photo customNegPrompt: type: string description: Negative prompt to avoid unwanted artifacts. example: blur, distorted hands genOriRes: type: boolean description: Whether to generate the original resolution. Defaults to false. example: false realModel: type: boolean description: Whether to prefer a realistic model style. example: true outputNum: type: integer description: Number of images to generate, from 1 to 4. Defaults to 1. example: 1 required: - imageUrl - modelHeadImageUrl example: imageUrl: https://example.com/source-image.jpg modelHeadImageUrl: https://example.com/model-reference.jpg imageSegUrl: https://example.com/mask.png sceneImgUrl: https://example.com/scene.jpg sceneStrength: 0.7 modelPrompt: smile, slim customPrompt: clean ecommerce catalog photo customNegPrompt: blur, distorted hands genOriRes: false realModel: true outputNum: 1 additionalProperties: true example: imageUrl: https://example.com/source-image.jpg modelHeadImageUrl: https://example.com/model-reference.jpg imageSegUrl: https://example.com/mask.png sceneImgUrl: https://example.com/scene.jpg sceneStrength: 0.7 modelPrompt: smile, slim customPrompt: clean ecommerce catalog photo customNegPrompt: blur, distorted hands genOriRes: false realModel: true outputNum: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: ai-model-swap x-nexscope-mcp-tool-name: nexscope_ai_model_swap x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/ai-model-swap-2-0/run: post: tags: - Multimodal AI summary: AI Model Swap API 2.0 description: Generate model images from a product image and a full model reference image with optional segmentation and scene controls. operationId: runAiModelSwap20 externalDocs: description: AI Model Swap API 2.0 documentation url: https://www.nexscope.ai/api-docs/ai-model-swap-2-0 requestBody: required: true content: application/json: schema: type: object description: Generate model images from a product image and a full model reference image with optional segmentation and scene controls. properties: imageUrl: type: string description: Public URL of the source product or outfit image. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height. example: https://example.com/source-image.jpg modelImageUrl: type: string description: Public URL of the full model reference image. example: https://example.com/model-reference.jpg outputNum: type: integer description: Number of images to generate, from 1 to 4. Defaults to 1. example: 1 imageSegUrl: type: string description: Optional segmentation mask URL for the source image. example: https://example.com/mask.png sceneImgUrl: type: string description: Optional scene reference image URL. example: https://example.com/scene.jpg sceneStrength: type: number description: Scene reference strength from 0 to 1. Defaults to 0.7. example: 0.7 genOriRes: type: boolean description: Whether to generate the original resolution. Defaults to false. example: false realModel: type: boolean description: Whether to prefer a realistic model style. example: true required: - imageUrl - modelImageUrl example: imageUrl: https://example.com/source-image.jpg modelImageUrl: https://example.com/model-reference.jpg outputNum: 1 imageSegUrl: https://example.com/mask.png sceneImgUrl: https://example.com/scene.jpg sceneStrength: 0.7 genOriRes: false realModel: true additionalProperties: true example: imageUrl: https://example.com/source-image.jpg modelImageUrl: https://example.com/model-reference.jpg outputNum: 1 imageSegUrl: https://example.com/mask.png sceneImgUrl: https://example.com/scene.jpg sceneStrength: 0.7 genOriRes: false realModel: true responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: ai-model-swap-2-0 x-nexscope-mcp-tool-name: nexscope_ai_model_swap_2_0 x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/ai-model-scene-background-replacement/run: post: tags: - Multimodal AI summary: AI Model Scene & Background Replacement API description: Generate scene variants for a model image using either a scene reference image or a text scene prompt. operationId: runAiModelSceneBackgroundReplacement externalDocs: description: AI Model Scene & Background Replacement API documentation url: https://www.nexscope.ai/api-docs/ai-model-scene-background-replacement requestBody: required: true content: application/json: schema: type: object description: Generate scene variants for a model image using either a scene reference image or a text scene prompt. properties: imageUrl: type: string description: Public URL of the model image. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height. example: https://example.com/model-reference.jpg sceneImgUrl: type: string description: Optional public URL of the target scene reference. example: https://example.com/scene.jpg scenePrompt: type: string description: Optional text prompt describing the target scene. example: bright studio showroom imageSegUrl: type: string description: Optional model segmentation mask URL. example: https://example.com/mask.png sceneStrength: type: number description: Scene reference strength from 0 to 1. Defaults to 0.7. example: 0.7 genOriRes: type: boolean description: Whether to generate the original resolution. Defaults to false. example: false realModel: type: boolean description: Whether to prefer realistic model rendering. example: true outputNum: type: integer description: Number of images to generate, from 1 to 4. Defaults to 1. example: 1 required: - imageUrl example: imageUrl: https://example.com/model-reference.jpg scenePrompt: bright studio showroom sceneStrength: 0.7 genOriRes: false realModel: true outputNum: 1 additionalProperties: true example: imageUrl: https://example.com/model-reference.jpg scenePrompt: bright studio showroom sceneStrength: 0.7 genOriRes: false realModel: true outputNum: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: ai-model-scene-background-replacement x-nexscope-mcp-tool-name: nexscope_ai_model_scene_background_replacement x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/ai-clothes-changer-for-tops-bottoms/run: post: tags: - Multimodal AI summary: AI Clothes Changer API for Tops & Bottoms description: Dress a model image with upper and/or lower garment assets, supporting optional masks and original garment references. operationId: runAiClothesChangerForTopsBottoms externalDocs: description: AI Clothes Changer API for Tops & Bottoms documentation url: https://www.nexscope.ai/api-docs/ai-clothes-changer-for-tops-bottoms requestBody: required: true content: application/json: schema: type: object description: Dress a model image with upper and/or lower garment assets, supporting optional masks and original garment references. properties: modelImageUrl: type: string description: Public URL of the model image. example: https://example.com/model-reference.jpg upperOriginUrl: type: string description: Public URL of the original upper garment image. The image must be up to 20 MB and between 385 and 4096 pixels in both width and height. example: https://example.com/top.jpg downOriginUrl: type: string description: Public URL of the original lower garment image. The image must be up to 20 MB and between 385 and 4096 pixels in both width and height. example: https://example.com/bottom.jpg upperImageUrl: type: string description: Optional processed upper garment mask or crop URL. example: https://example.com/top-mask.png downImageUrl: type: string description: Optional processed lower garment mask or crop URL. example: https://example.com/bottom-mask.png modelMaskImageUrl: type: string description: Optional mask URL for the model body area. example: https://example.com/mask.png outputNum: type: integer description: Number of images to generate, from 1 to 4. Defaults to 1. example: 1 required: - modelImageUrl example: modelImageUrl: https://example.com/model-reference.jpg upperOriginUrl: https://example.com/top.jpg downOriginUrl: https://example.com/bottom.jpg upperImageUrl: https://example.com/top-mask.png downImageUrl: https://example.com/bottom-mask.png modelMaskImageUrl: https://example.com/mask.png outputNum: 1 additionalProperties: true example: modelImageUrl: https://example.com/model-reference.jpg upperOriginUrl: https://example.com/top.jpg downOriginUrl: https://example.com/bottom.jpg upperImageUrl: https://example.com/top-mask.png downImageUrl: https://example.com/bottom-mask.png modelMaskImageUrl: https://example.com/mask.png outputNum: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: ai-clothes-changer-for-tops-bottoms x-nexscope-mcp-tool-name: nexscope_ai_clothes_changer_for_tops_bottoms x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/ai-suit-virtual-try-on/run: post: tags: - Multimodal AI summary: AI Suit Virtual Try-On API description: Dress a model image with a one-piece outfit or suit image, supporting optional garment and model masks. operationId: runAiSuitVirtualTryOn externalDocs: description: AI Suit Virtual Try-On API documentation url: https://www.nexscope.ai/api-docs/ai-suit-virtual-try-on requestBody: required: true content: application/json: schema: type: object description: Dress a model image with a one-piece outfit or suit image, supporting optional garment and model masks. properties: suitOriginUrl: type: string description: Public URL of the original one-piece garment image. The image must be up to 20 MB and between 385 and 4096 pixels in both width and height. example: https://example.com/suit.jpg modelImageUrl: type: string description: Public URL of the model image. example: https://example.com/model-reference.jpg suitImageUrl: type: string description: Optional processed suit mask or crop URL. example: https://example.com/suit-mask.png modelMaskImageUrl: type: string description: Optional mask URL for the model body area. example: https://example.com/mask.png outputNum: type: integer description: Number of images to generate, from 1 to 4. Defaults to 1. example: 1 required: - suitOriginUrl - modelImageUrl example: suitOriginUrl: https://example.com/suit.jpg modelImageUrl: https://example.com/model-reference.jpg suitImageUrl: https://example.com/suit-mask.png modelMaskImageUrl: https://example.com/mask.png outputNum: 1 additionalProperties: true example: suitOriginUrl: https://example.com/suit.jpg modelImageUrl: https://example.com/model-reference.jpg suitImageUrl: https://example.com/suit-mask.png modelMaskImageUrl: https://example.com/mask.png outputNum: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: ai-suit-virtual-try-on x-nexscope-mcp-tool-name: nexscope_ai_suit_virtual_try_on x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/virtual-try-on/run: post: tags: - Multimodal AI summary: Virtual Try-On API description: Generate wearable-product imagery from a source person image and target product image. operationId: runVirtualTryOn externalDocs: description: Virtual Try-On API documentation url: https://www.nexscope.ai/api-docs/virtual-try-on requestBody: required: true content: application/json: schema: type: object description: Generate wearable-product imagery from a source person image and target product image. properties: imageUrl: type: string description: Public URL of the wearable product image. The image must be between 300 and 4096 pixels in both width and height. The width-to-height ratio must be between 0.4 and 2.5. example: https://example.com/product.jpg targetOriginUrl: type: string description: Public URL of the person or model image. example: https://example.com/model-reference.jpg targetMaskUrl: type: string description: Public URL of the black-and-white target wear-area mask. Required because this API accepts custom target images rather than saved upstream materials. example: https://example.com/mask.png productCategory: type: string description: 'Product category. Supported values: footwear (shoes), luggage (bags), eyewear (glasses), necklace, hat, earring, ring, wristband, watch, headwear, belt, other.' example: hat outputNum: type: integer description: Number of images to generate, from 1 to 4. Defaults to 1. example: 1 required: - imageUrl - targetOriginUrl - targetMaskUrl example: imageUrl: https://example.com/product.jpg targetOriginUrl: https://example.com/model-reference.jpg targetMaskUrl: https://example.com/mask.png productCategory: hat outputNum: 1 additionalProperties: true example: imageUrl: https://example.com/product.jpg targetOriginUrl: https://example.com/model-reference.jpg targetMaskUrl: https://example.com/mask.png productCategory: hat outputNum: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: virtual-try-on x-nexscope-mcp-tool-name: nexscope_virtual_try_on x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/product-replacement/run: post: tags: - Multimodal AI summary: Product Replacement API description: Use source and target product references to replace product content while preserving scene consistency. operationId: runProductReplacement externalDocs: description: Product Replacement API documentation url: https://www.nexscope.ai/api-docs/product-replacement requestBody: required: true content: application/json: schema: type: object description: Use source and target product references to replace product content while preserving scene consistency. properties: imageUrl: type: string description: Public URL of the base image. The image must be up to 20 MB and between 384 and 8192 pixels in both width and height. example: https://example.com/source-image.jpg targetOriginUrl: type: string description: Public URL of the replacement product image. example: https://example.com/product.jpg sourceImageUrl: type: string description: Optional source product crop URL. example: https://example.com/source-product.jpg targetImageUrl: type: string description: Optional processed replacement product URL. example: https://example.com/target-product.png denoiseStrength: type: number description: Generation denoise strength from 0 to 1. Defaults to 0.5. example: 0.5 imageOutputWidth: type: integer description: Desired output width in pixels, from 32 to 4096. example: 1024 imageOutputHeight: type: integer description: Desired output height in pixels, from 32 to 4096. example: 1024 outputNum: type: integer description: Number of images to generate, from 1 to 4. Defaults to 1. example: 1 required: - imageUrl - targetOriginUrl example: imageUrl: https://example.com/source-image.jpg targetOriginUrl: https://example.com/product.jpg sourceImageUrl: https://example.com/source-product.jpg targetImageUrl: https://example.com/target-product.png denoiseStrength: 0.5 imageOutputWidth: 1024 imageOutputHeight: 1024 outputNum: 1 additionalProperties: true example: imageUrl: https://example.com/source-image.jpg targetOriginUrl: https://example.com/product.jpg sourceImageUrl: https://example.com/source-product.jpg targetImageUrl: https://example.com/target-product.png denoiseStrength: 0.5 imageOutputWidth: 1024 imageOutputHeight: 1024 outputNum: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: product-replacement x-nexscope-mcp-tool-name: nexscope_product_replacement x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/product-scene-variations/run: post: tags: - Multimodal AI summary: Product Scene Variations API description: Generate multiple ecommerce scene variants from a product image, optional segmentation, and prompt guidance. operationId: runProductSceneVariations externalDocs: description: Product Scene Variations API documentation url: https://www.nexscope.ai/api-docs/product-scene-variations requestBody: required: true content: application/json: schema: type: object description: Generate multiple ecommerce scene variants from a product image, optional segmentation, and prompt guidance. properties: imageUrl: type: string description: Public URL of the product image. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height. example: https://example.com/product.jpg segImageUrl: type: string description: Optional segmentation mask URL. example: https://example.com/mask.png strength: type: number description: Variation strength from 0.1 to 1. Defaults to 0.5. example: 0.5 prompt: type: string description: Scene generation prompt, up to 600 characters. example: modern kitchen countertop imageOutputWidth: type: integer description: Desired output width in pixels, from 32 to 2048. example: 1024 imageOutputHeight: type: integer description: Desired output height in pixels, from 32 to 2048. example: 1024 outputNum: type: integer description: Number of images to generate, from 1 to 4. example: 1 required: - imageUrl example: imageUrl: https://example.com/product.jpg segImageUrl: https://example.com/mask.png strength: 0.5 prompt: modern kitchen countertop imageOutputWidth: 1024 imageOutputHeight: 1024 outputNum: 1 additionalProperties: true example: imageUrl: https://example.com/product.jpg segImageUrl: https://example.com/mask.png strength: 0.5 prompt: modern kitchen countertop imageOutputWidth: 1024 imageOutputHeight: 1024 outputNum: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: product-scene-variations x-nexscope-mcp-tool-name: nexscope_product_scene_variations x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/ai-background-generator/run: post: tags: - Multimodal AI summary: AI Background Generator API description: Create product or lifestyle scene images from text prompts and optional reference images. operationId: runAiBackgroundGenerator externalDocs: description: AI Background Generator API documentation url: https://www.nexscope.ai/api-docs/ai-background-generator requestBody: required: true content: application/json: schema: type: object description: Create product or lifestyle scene images from text prompts and optional reference images. properties: prompt: type: string description: Text prompt describing the desired scene. example: a premium phone case on a clean marble desk imageUrl: type: string description: Optional reference image URL. example: https://example.com/product.jpg style: type: string description: 'Style preset. Supported values: scene-material, portrait-material, ancient-chinese, expressive-sketch, cyberpunk, pixel-illustration, tranquil-ink, anime-line-art, makoto-shinkai, hayao-miyazaki, cg, monochrome-illustration, retro-anime, chibi-character, realistic-oil-painting, c4d-paper-cut, expressive-watercolor, fresh-anime.' example: scene-material scale: type: string description: 'Output aspect ratio. Supported values: 1:1, 16:9, 9:16. Defaults to 1:1.' example: '1:1' outputNum: type: integer description: Number of images to generate, from 1 to 4. Defaults to 4. example: 4 required: - prompt example: prompt: a premium phone case on a clean marble desk imageUrl: https://example.com/product.jpg style: scene-material scale: '1:1' outputNum: 4 additionalProperties: true example: prompt: a premium phone case on a clean marble desk imageUrl: https://example.com/product.jpg style: scene-material scale: '1:1' outputNum: 4 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: ai-background-generator x-nexscope-mcp-tool-name: nexscope_ai_background_generator x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/similar-image-variations/run: post: tags: - Multimodal AI summary: Similar Image Variations API description: Generate similar ecommerce images from a reference image with optional prompt and strength controls. operationId: runSimilarImageVariations externalDocs: description: Similar Image Variations API documentation url: https://www.nexscope.ai/api-docs/similar-image-variations requestBody: required: true content: application/json: schema: type: object description: Generate similar ecommerce images from a reference image with optional prompt and strength controls. properties: imageUrl: type: string description: Public URL of a JPG, PNG, or WEBP reference image up to 10 MB and at most 4096 pixels in both width and height. example: https://example.com/product.jpg prompt: type: string description: Optional prompt for the desired variation, up to 600 characters. example: same product, brighter background weight: type: integer description: Reference image weight from 0 to 2. Defaults to 2. example: 2 width: type: integer description: Desired output width in pixels, from 384 to 4096. example: 1024 minimum: 384 maximum: 4096 height: type: integer description: Desired output height in pixels, from 384 to 4096. example: 1024 minimum: 384 maximum: 4096 scale: type: string description: Optional aspect ratio. Provide scale or both width and height. example: '1:1' outputNum: type: integer description: Number of images to generate, from 1 to 4. Defaults to 4. example: 4 required: - imageUrl example: imageUrl: https://example.com/product.jpg prompt: same product, brighter background weight: 2 width: 1024 height: 1024 outputNum: 4 additionalProperties: true example: imageUrl: https://example.com/product.jpg prompt: same product, brighter background weight: 2 width: 1024 height: 1024 outputNum: 4 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: similar-image-variations x-nexscope-mcp-tool-name: nexscope_similar_image_variations x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/background-remover/run: post: tags: - Multimodal AI summary: Background Remover API description: Cut out products, people, or clothing from a source image using an upstream background-removal model. operationId: runBackgroundRemover externalDocs: description: Background Remover API documentation url: https://www.nexscope.ai/api-docs/background-remover requestBody: required: true content: application/json: schema: type: object description: Cut out products, people, or clothing from a source image using an upstream background-removal model. properties: imageUrl: type: string description: Public URL of the image to cut out. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height. example: https://example.com/product.jpg subType: type: integer description: 'Cutout type. Supported values: 1 (general), 2 (portrait), 3 (product), 9 (apparel), 12 (hair), 13 (face).' example: 1 clothClass: type: string description: 'Apparel classes used only when subType is 9. Multiple values may be comma-separated. Supported values: tops, coat, skirt, pants, bag, shoes, hat.' example: tops required: - imageUrl - subType example: imageUrl: https://example.com/product.jpg subType: 1 additionalProperties: true example: imageUrl: https://example.com/product.jpg subType: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: background-remover x-nexscope-mcp-tool-name: nexscope_background_remover x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/fine-cutout-image-segmentation/run: post: tags: - Multimodal AI summary: Fine Cutout Image Segmentation API description: Run the Nexscope interactive cutout create/info flow as one Skill API call. The point list marks foreground/background guidance points. operationId: runFineCutoutImageSegmentation externalDocs: description: Fine Cutout Image Segmentation API documentation url: https://www.nexscope.ai/api-docs/fine-cutout-image-segmentation requestBody: required: true content: application/json: schema: type: object description: Run the Nexscope interactive cutout create/info flow as one Skill API call. The point list marks foreground/background guidance points. properties: imageUrl: type: string description: Public URL of the image to cut out. example: https://example.com/product.jpg pointList: type: array items: type: object properties: x: type: integer y: type: integer isSelect: type: boolean additionalProperties: true description: Selection points. Each item should include x, y, and isSelect. example: - x: 120 y: 180 isSelect: true scoreUrl: type: string description: Optional score map URL returned by a previous step. example: https://example.com/score.png featureUrl: type: string description: Optional feature map URL returned by a previous step. example: https://example.com/feature.bin required: - imageUrl - pointList example: imageUrl: https://example.com/product.jpg pointList: - x: 120 y: 180 isSelect: true scoreUrl: https://example.com/score.png featureUrl: https://example.com/feature.bin additionalProperties: true example: imageUrl: https://example.com/product.jpg pointList: - x: 120 y: 180 isSelect: true scoreUrl: https://example.com/score.png featureUrl: https://example.com/feature.bin responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: fine-cutout-image-segmentation x-nexscope-mcp-tool-name: nexscope_fine_cutout_image_segmentation x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/image-upscale/run: post: tags: - Multimodal AI summary: Image Upscale API description: Increase image resolution and optionally enhance visual quality. operationId: runImageUpscale externalDocs: description: Image Upscale API documentation url: https://www.nexscope.ai/api-docs/image-upscale requestBody: required: true content: application/json: schema: type: object description: Increase image resolution and optionally enhance visual quality. properties: imageUrl: type: string description: Public URL of the image to upscale. Width and height must each be at most 4096 pixels. example: https://example.com/product.jpg magnification: type: number description: Upscaling magnification factor from 1 to 4. Decimal values are supported. example: 2 enhanceQuality: type: boolean description: Whether to enhance image quality during upscaling. example: true required: - imageUrl - magnification example: imageUrl: https://example.com/product.jpg magnification: 2 enhanceQuality: true additionalProperties: true example: imageUrl: https://example.com/product.jpg magnification: 2 enhanceQuality: true responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: image-upscale x-nexscope-mcp-tool-name: nexscope_image_upscale x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/smart-image-outpainting/run: post: tags: - Multimodal AI summary: Smart Image Outpainting API description: Generate an expanded image around the original content using target width, height, and optional prompt. operationId: runSmartImageOutpainting externalDocs: description: Smart Image Outpainting API documentation url: https://www.nexscope.ai/api-docs/smart-image-outpainting requestBody: required: true content: application/json: schema: type: object description: Generate an expanded image around the original content using target width, height, and optional prompt. properties: imageUrl: type: string description: Public URL of the image to expand. 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 width: type: integer description: Target output width in pixels. example: 1200 height: type: integer description: Target output height in pixels. example: 900 prompt: type: string description: Optional prompt describing the extended scene. example: extend the clean studio background outputNum: type: integer description: Number of images to generate, from 1 to 4. Defaults to 1. example: 1 required: - imageUrl - width - height example: imageUrl: https://example.com/product.jpg width: 1200 height: 900 prompt: extend the clean studio background outputNum: 1 additionalProperties: true example: imageUrl: https://example.com/product.jpg width: 1200 height: 900 prompt: extend the clean studio background outputNum: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: smart-image-outpainting x-nexscope-mcp-tool-name: nexscope_smart_image_outpainting x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/image-translation/run: post: tags: - Multimodal AI summary: Image Translation API description: Translate image text from a source language to a target language for ecommerce localization. operationId: runImageTranslation externalDocs: description: Image Translation API documentation url: https://www.nexscope.ai/api-docs/image-translation requestBody: required: true content: application/json: schema: type: object description: Translate image text from a source language to a target language for ecommerce localization. properties: imageUrl: type: string description: Public URL of a JPG, JPEG, PNG, or WEBP image up to 4 MB and between 385 and 3000 pixels. example: https://example.com/product.jpg translationPlatform: type: string description: 'Translation platform. Supported values: deepl (DeepL), chatgpt (ChatGPT).' example: deepl sourceLanguage: type: string description: 'Source language code. Supported values: CHS (Simplified Chinese), ENG (English), CHT (Traditional Chinese), ESP (Spanish), JPN (Japanese), KOR (Korean), PT (Portuguese), ROM (Romanian), RUS (Russian), VIN (Vietnamese), DEU (German).' example: CHS targetLanguage: type: string description: 'Target language code. Supported values: AR, BG, BN, CHS, CHT, CKB, CSY, DA, DEU, EL, ENG, ESP, ET, FA, FI, FIL, FRA, GU, HE, HI, HR, HUN, ID, ITA, JPN, JW, KOR, LO, LT, LV, MR, MS, MY, NLD, NO, PLK, PT, PTB, ROM, RUS, SK, SL, SV, SW, TA, TE, TG, TH, TL, TRK, UK, UR, VIN.' example: ENG required: - imageUrl - translationPlatform - sourceLanguage - targetLanguage example: imageUrl: https://example.com/product.jpg translationPlatform: deepl sourceLanguage: CHS targetLanguage: ENG additionalProperties: true example: imageUrl: https://example.com/product.jpg translationPlatform: deepl sourceLanguage: CHS targetLanguage: ENG responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: image-translation x-nexscope-mcp-tool-name: nexscope_image_translation x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/ai-hand-repair/run: post: tags: - Multimodal AI summary: AI Hand Repair API description: Improve hand appearance in generated model or lifestyle images. operationId: runAiHandRepair externalDocs: description: AI Hand Repair API documentation url: https://www.nexscope.ai/api-docs/ai-hand-repair requestBody: required: true content: application/json: schema: type: object description: Improve hand appearance in generated model or lifestyle images. properties: imageUrl: type: string description: Public URL of the image requiring hand repair. 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/model-reference.jpg personType: type: integer description: 'Person type. Supported values: 0 (girl), 1 (boy), 2 (adult woman), 3 (adult man).' example: 2 maskUrl: type: string description: Optional mask URL for the hand repair area. example: https://example.com/mask.png outputNum: type: integer description: Number of images to generate, from 1 to 4. Defaults to 1. example: 1 required: - imageUrl - personType example: imageUrl: https://example.com/model-reference.jpg personType: 2 maskUrl: https://example.com/mask.png outputNum: 1 additionalProperties: true example: imageUrl: https://example.com/model-reference.jpg personType: 2 maskUrl: https://example.com/mask.png outputNum: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: ai-hand-repair x-nexscope-mcp-tool-name: nexscope_ai_hand_repair x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/image-inpainting/run: post: tags: - Multimodal AI summary: Image Inpainting API description: Repair or regenerate a local image region using a mask and prompt. operationId: runImageInpainting externalDocs: description: Image Inpainting API documentation url: https://www.nexscope.ai/api-docs/image-inpainting requestBody: required: true content: application/json: schema: type: object description: Repair or regenerate a local image region using a mask and prompt. properties: imageUrl: type: string description: Public URL of the base image. 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: type: string description: Prompt describing how to redraw the masked area. example: remove scratches and keep the product realistic maskUrl: type: string description: Public URL of the mask image. example: https://example.com/mask.png outputNum: type: integer description: Number of images to generate, from 1 to 4. Defaults to 1. example: 1 required: - imageUrl - prompt - maskUrl example: imageUrl: https://example.com/product.jpg prompt: remove scratches and keep the product realistic maskUrl: https://example.com/mask.png outputNum: 1 additionalProperties: true example: imageUrl: https://example.com/product.jpg prompt: remove scratches and keep the product realistic maskUrl: https://example.com/mask.png outputNum: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: image-inpainting x-nexscope-mcp-tool-name: nexscope_image_inpainting x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/print-pattern-extraction/run: post: tags: - Multimodal AI summary: Print & Pattern Extraction API description: Extract visible print or pattern elements from product imagery. operationId: runPrintPatternExtraction externalDocs: description: Print & Pattern Extraction API documentation url: https://www.nexscope.ai/api-docs/print-pattern-extraction requestBody: required: true content: application/json: schema: type: object description: Extract visible print or pattern elements from product imagery. properties: imageUrl: type: string description: Public URL of the image containing the print. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height. example: https://example.com/product.jpg required: - imageUrl example: imageUrl: https://example.com/product.jpg additionalProperties: true example: imageUrl: https://example.com/product.jpg responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: print-pattern-extraction x-nexscope-mcp-tool-name: nexscope_print_pattern_extraction x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/object-eraser-image-object-removal/run: post: tags: - Multimodal AI summary: Object Eraser & Image Object Removal API description: Remove selected objects or regions using a mask image. operationId: runObjectEraserImageObjectRemoval externalDocs: description: Object Eraser & Image Object Removal API documentation url: https://www.nexscope.ai/api-docs/object-eraser-image-object-removal requestBody: required: true content: application/json: schema: type: object description: Remove selected objects or regions using a mask image. properties: imageUrl: type: string description: Public URL of the base image. 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 maskImageUrl: type: string description: Public URL of the mask image for the area to erase. example: https://example.com/mask.png required: - imageUrl - maskImageUrl example: imageUrl: https://example.com/product.jpg maskImageUrl: https://example.com/mask.png additionalProperties: true example: imageUrl: https://example.com/product.jpg maskImageUrl: https://example.com/mask.png responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: object-eraser-image-object-removal x-nexscope-mcp-tool-name: nexscope_object_eraser_image_object_removal x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/jewelry-text-design/run: post: tags: - Multimodal AI summary: Jewelry Text Design API description: Create decorative linked-word imagery using font, size, and prompt controls. operationId: runJewelryTextDesign externalDocs: description: Jewelry Text Design API documentation url: https://www.nexscope.ai/api-docs/jewelry-text-design requestBody: required: true content: application/json: schema: type: object description: Create decorative linked-word imagery using font, size, and prompt controls. properties: fontname: type: string description: 'Font name. Allowed values: Caitlyn, ItaliannoRob, Alison, ALSScript, WhiteAngelica, Milkshake, ScriptMTBold, PassionsConflictROB, Sacramento, Cervanttis, Notera 2 PERSONAL USE ONLY, UyghurMerdane, OldEnglishText, Halimun, AlexBrush, Scriptina, CounselorScript, EliannaBoldItalic, AutumnChant, MagnoliaScript.' example: UyghurMerdane fontSize: type: integer description: Output font size. example: 10 left: type: boolean description: Whether to add a ring on the left side. Defaults to false. example: false right: type: boolean description: Whether to add a ring on the right side. Defaults to false. example: false prompt: type: string description: Jewelry text content. example: hello required: - fontname - fontSize - prompt example: fontname: UyghurMerdane fontSize: 10 left: false right: false prompt: hello additionalProperties: true example: fontname: UyghurMerdane fontSize: 10 left: false right: false prompt: hello responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: jewelry-text-design x-nexscope-mcp-tool-name: nexscope_jewelry_text_design x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/handheld-product-mockup/run: post: tags: - Multimodal AI summary: Handheld Product Mockup API description: Generate natural hand-held product imagery from a person image and target product asset. operationId: runHandheldProductMockup externalDocs: description: Handheld Product Mockup API documentation url: https://www.nexscope.ai/api-docs/handheld-product-mockup requestBody: required: true content: application/json: schema: type: object description: Generate natural hand-held product imagery from a person image and target product asset. properties: imageUrl: type: string description: Public URL of the product image. The image must be at most 20 MB and between 385 and 8192 pixels in both width and height. example: https://example.com/product.jpg targetOriginUrl: type: string description: Public URL of the person or hand pose image. example: https://example.com/model-reference.jpg targetMaskUrl: type: string description: Public URL of the black-and-white hand-held area mask. Required because this API accepts custom pose images rather than saved upstream materials. example: https://example.com/mask.png outputNum: type: integer description: Number of images to generate, from 1 to 4. Defaults to 1. example: 1 required: - imageUrl - targetOriginUrl - targetMaskUrl example: imageUrl: https://example.com/product.jpg targetOriginUrl: https://example.com/model-reference.jpg targetMaskUrl: https://example.com/mask.png outputNum: 1 additionalProperties: true example: imageUrl: https://example.com/product.jpg targetOriginUrl: https://example.com/model-reference.jpg targetMaskUrl: https://example.com/mask.png outputNum: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: handheld-product-mockup x-nexscope-mcp-tool-name: nexscope_handheld_product_mockup x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/image-captioning/run: post: tags: - Multimodal AI summary: Image Captioning API description: Extract descriptive prompts or selling-point text from one or more images. operationId: runImageCaptioning externalDocs: description: Image Captioning API documentation url: https://www.nexscope.ai/api-docs/image-captioning requestBody: required: true content: application/json: schema: type: object description: Extract descriptive prompts or selling-point text from one or more images. properties: type: type: integer description: 'Analysis type. Supported values: 5 (similar-image prompt), 13 (scene prompt), 30 (image-to-video analysis), 69 (apparel selling points), 71 (product selling points), 73 (sales-video script), 89 (video-reclone prompt).' example: 71 imageUrlList: type: array items: type: string description: Public image URLs used for analysis. Provide no more than 6 images for modes that accept multiple images. example: - https://example.com/product.jpg minItems: 1 maxItems: 6 keyword: type: string description: Optional keyword context. example: phone case provider: type: string description: 'Analysis provider. Supported values: API_PRE_POINT (default), API_LAYOUT_DESC.' example: API_PRE_POINT refVideoUrl: type: string description: Reference video URL. Required when type is 89. example: https://example.com/reference-video.mp4 saleCountry: type: string description: Target sale country code. example: US targetLanguage: type: string description: Target language for generated text. Used by video-reclone analysis. example: English duration: type: integer description: Target duration in seconds. Used by video-reclone analysis. example: 15 required: - type - imageUrlList example: type: 71 imageUrlList: - https://example.com/product.jpg keyword: phone case provider: API_PRE_POINT additionalProperties: true example: type: 71 imageUrlList: - https://example.com/product.jpg keyword: phone case provider: API_PRE_POINT responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: image-captioning x-nexscope-mcp-tool-name: nexscope_image_captioning x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/product-image-enhancement/run: post: tags: - Multimodal AI summary: Product Image Enhancement API description: Improve product presentation quality in a single ecommerce image. operationId: runProductImageEnhancement externalDocs: description: Product Image Enhancement API documentation url: https://www.nexscope.ai/api-docs/product-image-enhancement requestBody: required: true content: application/json: schema: type: object description: Improve product presentation quality in a single ecommerce image. properties: imageUrl: type: string description: Public URL of the product image to retouch. The image must be up to 20 MB and between 385 and 8192 pixels in both width and height. example: https://example.com/product.jpg required: - imageUrl example: imageUrl: https://example.com/product.jpg additionalProperties: true example: imageUrl: https://example.com/product.jpg responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: product-image-enhancement x-nexscope-mcp-tool-name: nexscope_product_image_enhancement x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/image-text-editing/run: post: tags: - Multimodal AI summary: Image Text Editing API description: Use an image mask to remove or edit text regions in an ecommerce image. operationId: runImageTextEditing externalDocs: description: Image Text Editing API documentation url: https://www.nexscope.ai/api-docs/image-text-editing requestBody: required: true content: application/json: schema: type: object description: Use an image mask to remove or edit text regions in an ecommerce image. properties: imageUrl: type: string description: Public URL of the base image. example: https://example.com/product.jpg imageMaskUrl: type: string description: Public URL of the text mask image. example: https://example.com/mask.png required: - imageUrl - imageMaskUrl example: imageUrl: https://example.com/product.jpg imageMaskUrl: https://example.com/mask.png additionalProperties: true example: imageUrl: https://example.com/product.jpg imageMaskUrl: https://example.com/mask.png responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: image-text-editing x-nexscope-mcp-tool-name: nexscope_image_text_editing x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/smart-image-edit-manipulation-v3/run: post: tags: - Multimodal AI summary: Smart Image Edit & Manipulation API v3 description: Perform general image editing with provider, prompt, resolution, aspect ratio, and quality controls. operationId: runSmartImageEditManipulationV3 externalDocs: description: Smart Image Edit & Manipulation API v3 documentation url: https://www.nexscope.ai/api-docs/smart-image-edit-manipulation-v3 requestBody: required: true content: application/json: schema: type: object description: Perform general image editing with provider, prompt, resolution, aspect ratio, and quality controls. properties: imageUrl: type: string description: 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: type: string description: Editing instruction. example: make the background pure white and keep the product unchanged provider: type: string description: 'Image model. Supported values: BANANA, BANANA_2, BANANA_PRO, WAN2_7, QWEN_IMAGE_3_PRO, SEEDREAM5, GPT_2_IMAGE, or AIDRAW_EDIT.' example: BANANA_PRO outputNum: type: integer description: Number of images to generate, from 1 to 4. example: 1 resolution: type: string description: Target resolution preset. example: 1K aspectRatio: type: string description: Target aspect ratio. example: '1:1' supplyType: type: string description: 'Generation route. Supported values: eco or stable. Defaults to stable.' example: stable needOptimize: type: boolean description: Whether the prompt should be optimized upstream. example: true template: type: string description: '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.' example: white-background source: type: string description: Optional traffic or product source code. example: api quality: type: string description: 'GPT Image quality only. Supported values: low, medium, or high. Defaults to medium.' example: medium required: - imageUrl - prompt - provider example: 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 additionalProperties: true example: 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 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: smart-image-edit-manipulation-v3 x-nexscope-mcp-tool-name: nexscope_smart_image_edit_manipulation_v3 x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/whitebg-image/run: post: tags: - Multimodal AI summary: White Background Product Image API description: Generate one square white-background product image from one or two references of the same product using GPT Image 2. Submit one approved target per request. Review product identity and listing suitability before use; this endpoint does not perform reference inspection, image-set planning, or marketplace compliance certification. Generation consumes Nexscope credits. operationId: runWhitebgImage externalDocs: description: White Background Product Image API documentation url: https://www.nexscope.ai/api-docs/whitebg-image requestBody: required: true content: application/json: schema: type: object description: Generate one square white-background product image from one or two references of the same product using GPT Image 2. Submit one approved target per request. Review product identity and listing suitability before use; this endpoint does not perform reference inspection, image-set planning, or marketplace compliance certification. Generation consumes Nexscope credits. properties: imageList: type: array items: type: string description: Public reference image URLs of the same product. Provide up to 2 JPG, JPEG, PNG, or WEBP images; each image must be at most 10 MB and between 800 and 4096 pixels. example: - https://example.com/product.jpg minItems: 1 maxItems: 2 prompt: type: string description: Describe one target supported by the references, up to 350 characters. Output is fixed to one 1:1 image. example: Show the complete product from the supplied front view. maxLength: 350 required: - imageList - prompt example: imageList: - https://example.com/product.jpg prompt: Show the complete product from the supplied front view. additionalProperties: true example: imageList: - https://example.com/product.jpg prompt: Show the complete product from the supplied front view. responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: whitebg-image x-nexscope-mcp-tool-name: nexscope_whitebg_image x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/smart-multi-image-editing-v3/run: post: tags: - Multimodal AI summary: Smart Multi-Image Editing API v3 description: Create an edited output from multiple source images using prompt, provider, resolution, and quality controls. operationId: runSmartMultiImageEditingV3 externalDocs: description: Smart Multi-Image Editing API v3 documentation url: https://www.nexscope.ai/api-docs/smart-multi-image-editing-v3 requestBody: required: true content: application/json: schema: type: object description: Create an edited output from multiple source images using prompt, provider, resolution, and quality controls. properties: imageList: type: array items: type: string description: Public image URLs to combine or reference. Provide no more than 6 JPG, JPEG, PNG, or WEBP images; each image must be at most 10 MB and between 800 and 4096 pixels. example: - https://example.com/product.jpg - https://example.com/model-reference.jpg minItems: 1 maxItems: 6 provider: type: string description: 'Image model. Supported values: BANANA, BANANA_2, BANANA_PRO, WAN2_7, QWEN_IMAGE_3_PRO, SEEDREAM5, GPT_2_IMAGE, or AIDRAW_EDIT.' example: BANANA_PRO prompt: type: string description: Optional fusion instruction, up to 600 characters. example: combine the product with the model in a clean studio scene outputNum: type: integer description: Number of images to generate. Defaults to 1. example: 1 resolution: type: string description: Target resolution preset. example: 1K aspectRatio: type: string description: Target aspect ratio. example: '1:1' supplyType: type: string description: 'Generation route. Supported values: eco or stable. Defaults to stable.' example: stable needOptimize: type: boolean description: Whether the prompt should be optimized upstream. example: true template: type: string description: 'Optional fusion template. Supported values: outfit-fusion, outfit-try-on.' example: outfit-fusion quality: type: string description: 'GPT Image quality only. Supported values: low, medium, or high. Defaults to medium.' example: medium required: - imageList - provider example: imageList: - https://example.com/product.jpg - https://example.com/model-reference.jpg provider: BANANA_PRO prompt: combine the product with the model in a clean studio scene outputNum: 1 resolution: 1K aspectRatio: '1:1' supplyType: stable needOptimize: true template: outfit-fusion quality: medium additionalProperties: true example: imageList: - https://example.com/product.jpg - https://example.com/model-reference.jpg provider: BANANA_PRO prompt: combine the product with the model in a clean studio scene outputNum: 1 resolution: 1K aspectRatio: '1:1' supplyType: stable needOptimize: true template: outfit-fusion quality: medium responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: smart-multi-image-editing-v3 x-nexscope-mcp-tool-name: nexscope_smart_multi_image_editing_v3 x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/ai-video-reclone/run: post: tags: - Multimodal AI summary: AI Video Reclone API description: Generate a product marketing video using a reference video, reference images, and model-specific generation settings. operationId: runAiVideoReclone externalDocs: description: AI Video Reclone API documentation url: https://www.nexscope.ai/api-docs/ai-video-reclone requestBody: required: true content: application/json: schema: type: object description: Generate a product marketing video using a reference video, reference images, and model-specific generation settings. properties: refVideoUrl: type: string description: Public URL of the reference video. example: https://example.com/reference-video.mp4 refImageList: type: array items: type: string description: Public image URLs for product or visual references. example: - https://example.com/product.jpg videoType: type: string description: 'Video model. Supported values: seedance-2-0, seedance-2-0-fast, seedance-2-0-mini, seedance-2-5, or happyhorse-v2.' example: seedance-2-0-fast videoTime: type: integer description: Optional target video duration in seconds. Seedance 2.0, Fast, Mini, and HappyHorse V2 support any integer from 5 through 15; Seedance 2.5 supports 5, 10, 15, 20, 25, or 30. example: 10 resolution: type: string description: Target video resolution supported by the selected model, such as 720p or 1080p. example: 720p aspectRatio: type: string description: Target video aspect ratio supported by the selected model. example: '9:16' saleCountry: type: string description: Target market country code used to localize the recreated video. example: US targetLanguage: type: string description: Target spoken and on-screen language for the recreated video. example: English productInfo: type: string description: Concise product information used to guide the recreation. Maximum 2500 characters. example: Slim shockproof phone case with a clear finish. prompt: type: string description: Optional creative direction prompt. example: highlight the slim protective design required: - refVideoUrl - refImageList - videoType - resolution - saleCountry - targetLanguage example: refVideoUrl: https://example.com/reference-video.mp4 refImageList: - https://example.com/product.jpg videoType: seedance-2-0-fast videoTime: 10 resolution: 720p aspectRatio: '9:16' saleCountry: US targetLanguage: English productInfo: Slim shockproof phone case with a clear finish. prompt: highlight the slim protective design additionalProperties: true example: refVideoUrl: https://example.com/reference-video.mp4 refImageList: - https://example.com/product.jpg videoType: seedance-2-0-fast videoTime: 10 resolution: 720p aspectRatio: '9:16' saleCountry: US targetLanguage: English productInfo: Slim shockproof phone case with a clear finish. prompt: highlight the slim protective design responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: ai-video-reclone x-nexscope-mcp-tool-name: nexscope_ai_video_reclone x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/ai-product-marketing-image-set-v4/run: post: tags: - Multimodal AI summary: AI Product Marketing Image Set API v4 description: Create ecommerce product marketing materials such as selling-point images and A+ style visuals from product images and brief inputs. operationId: runAiProductMarketingImageSetV4 externalDocs: description: AI Product Marketing Image Set API v4 documentation url: https://www.nexscope.ai/api-docs/ai-product-marketing-image-set-v4 requestBody: required: true content: application/json: schema: type: object description: Create ecommerce product marketing materials such as selling-point images and A+ style visuals from product images and brief inputs. properties: imageList: type: array items: type: string description: Public product image URLs. Provide no more than 5 JPG, JPEG, PNG, or WEBP images; each image must be at most 10 MB and between 800 and 4096 pixels. example: - https://example.com/product.jpg minItems: 1 maxItems: 5 provider: type: string description: 'Image model. Defaults to BANANA_2. Supported values: BANANA_2, BANANA_2_LITE, BANANA_PRO, WAN2_7, SEEDREAM5_PRO, GPT_2_IMAGE.' example: BANANA_2 sellerPoint: type: string description: Product selling points, up to 2500 characters. Required when isExtractPrePoint is false. example: Shockproof, slim, clear phone case maxLength: 2500 isExtractPrePoint: type: boolean description: Whether to automatically extract selling points. Defaults to false. When false, sellerPoint is required. example: false resolution: type: string description: Target resolution supported by the selected provider. example: 2K aspectRatio: type: string description: Target aspect ratio supported by the selected provider. example: '1:1' noText: type: boolean description: Whether generated images should avoid text. example: false brandKey: type: string description: '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: type: string description: 'GPT Image quality only. Supported values: low, medium, or high.' example: medium sensitiveLibraryId: type: integer description: Optional sensitive-word library ID used to screen generated copy. example: 1001 replaceLibraryId: type: integer description: Optional replacement-word library ID used to rewrite generated copy. example: 1002 aPlusNum: type: integer description: Number of standard A+ images, from 0 to 12. Defaults to 0. example: 0 aPlusProNum: type: integer description: Number of premium A+ images, from 0 to 12. Defaults to 0. example: 0 aPlusHasPhone: type: boolean description: Whether A+ output includes phone display layouts. example: false aPlusAspectRatio: type: string description: 'Premium A+ aspect ratio. Supported values: 16:9, 9:16, 1:1, 1:3.7.' example: '1:1' sellerTypeNum: type: integer description: Number of selling-point images, from 0 to 12. Defaults to 0. example: 0 sceneTypeNum: type: integer description: Number of scene images, from 0 to 12. Defaults to 0. example: 0 closeUpTypeNum: type: integer description: Number of close-up images, from 0 to 12. Defaults to 0. example: 0 closeUpWhiteTypeNum: type: integer description: Number of white-background close-up images, from 0 to 12. Defaults to 0. example: 0 whiteBgTypeNum: type: integer description: Number of white-background images, from 0 to 12. Defaults to 0. example: 0 aPlusStyles: type: array items: type: object properties: id: type: integer prompt: type: string additionalProperties: true description: Optional A+ style entries. Each item may contain a saved style id or a custom prompt. example: - id: 1 - prompt: clean premium layout pointStyles: type: array items: type: object properties: id: type: integer prompt: type: string additionalProperties: true description: Optional selling-point style entries. Each item may contain a saved style id or a custom prompt. example: - id: 2 - prompt: minimal feature callouts required: - imageList example: imageList: - https://example.com/product.jpg provider: BANANA_2 sellerPoint: Shockproof, slim, clear phone case 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 aPlusNum: 0 aPlusProNum: 0 aPlusHasPhone: false aPlusAspectRatio: '1:1' sellerTypeNum: 0 sceneTypeNum: 0 closeUpTypeNum: 0 closeUpWhiteTypeNum: 0 whiteBgTypeNum: 0 aPlusStyles: - id: 1 - prompt: clean premium layout pointStyles: - id: 2 - prompt: minimal feature callouts additionalProperties: true example: imageList: - https://example.com/product.jpg provider: BANANA_2 sellerPoint: Shockproof, slim, clear phone case 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 aPlusNum: 0 aPlusProNum: 0 aPlusHasPhone: false aPlusAspectRatio: '1:1' sellerTypeNum: 0 sceneTypeNum: 0 closeUpTypeNum: 0 closeUpWhiteTypeNum: 0 whiteBgTypeNum: 0 aPlusStyles: - id: 1 - prompt: clean premium layout pointStyles: - id: 2 - prompt: minimal feature callouts responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: ai-product-marketing-image-set-v4 x-nexscope-mcp-tool-name: nexscope_ai_product_marketing_image_set_v4 x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/ai-apparel-image-set-photography-v3/run: post: tags: - Multimodal AI summary: AI Apparel Image Set & Photography API v3 description: Create apparel ecommerce image sets from clothing images with optional model and scene references. operationId: runAiApparelImageSetPhotographyV3 externalDocs: description: AI Apparel Image Set & Photography API v3 documentation url: https://www.nexscope.ai/api-docs/ai-apparel-image-set-photography-v3 requestBody: required: true content: application/json: schema: type: object description: Create apparel ecommerce image sets from clothing images with optional model and scene references. properties: imageList: type: array items: type: string description: 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 minItems: 1 maxItems: 5 provider: type: string description: 'Image model. Defaults to BANANA_2. Supported values: BANANA_2, BANANA_2_LITE, BANANA_PRO, WAN2_7, SEEDREAM5_PRO, GPT_2_IMAGE.' example: BANANA_2 sellerPoint: type: string description: Product selling points, up to 2500 characters. Required when isExtractPrePoint is false. example: Lightweight breathable summer dress maxLength: 2500 isExtractPrePoint: type: boolean description: Whether to automatically extract selling points. Defaults to false. When false, sellerPoint is required. example: false resolution: type: string description: Target resolution supported by the selected provider. example: 2K aspectRatio: type: string description: Target aspect ratio. example: '1:1' noText: type: boolean description: Whether generated images should avoid text. example: false brandKey: type: string description: '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: type: string description: 'GPT Image quality only. Supported values: low, medium, or high.' example: medium sensitiveLibraryId: type: integer description: Optional sensitive-word library ID used to screen generated copy. example: 1001 replaceLibraryId: type: integer description: Optional replacement-word library ID used to rewrite generated copy. example: 1002 modelImageUrl: type: string description: Optional model reference image URL. example: https://example.com/model-reference.jpg sceneImageUrl: type: string description: Optional scene reference image URL. example: https://example.com/scene.jpg isExactScene: type: boolean description: Whether to match the provided scene closely. Defaults to true. example: true modelAndSceneInfo: type: string description: Model and scene information serialized as a JSON string or concise structured text. example: '{"model":"female adult","scene":"studio"}' aPlusNum: type: integer description: Number of standard A+ images, from 0 to 12. Defaults to 0. example: 0 aPlusProNum: type: integer description: Number of premium A+ images, from 0 to 12. Defaults to 0. example: 0 aPlusHasPhone: type: boolean description: Whether A+ output includes phone display layouts. example: false aPlusAspectRatio: type: string description: 'A+ output aspect ratio. Supported values: 16:9, 9:16, 1:1, 1:3.7.' example: '1:1' modelTypeNum: type: integer description: Number of model images, from 0 to 12. Defaults to 0. example: 0 insTypeNum: type: integer description: Number of social-style images, from 0 to 12. Defaults to 0. example: 0 sellerTypeNum: type: integer description: Number of selling-point images, from 0 to 12. Defaults to 0. example: 0 sizeTypeNum: type: integer description: Number of size-information images, from 0 to 12. Defaults to 0. example: 0 whiteTypeNum: type: integer description: Number of white-background images, from 0 to 12. Defaults to 0. example: 0 aPlusStyles: type: array items: type: object properties: id: type: integer prompt: type: string additionalProperties: true description: Optional A+ style entries. Each item may contain a saved style id or a custom prompt. example: - id: 1 - prompt: clean editorial layout pointStyles: type: array items: type: object properties: id: type: integer prompt: type: string additionalProperties: true description: Optional selling-point style entries. Each item may contain a saved style id or a custom prompt. example: - id: 2 - prompt: minimal feature callouts required: - imageList example: 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 additionalProperties: true example: 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 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: ai-apparel-image-set-photography-v3 x-nexscope-mcp-tool-name: nexscope_ai_apparel_image_set_photography_v3 x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/ai-model-pose-generation/run: post: tags: - Multimodal AI summary: AI Model Pose Generation API description: Generate model pose variations from an input image and either a pose prompt or posture reference image. operationId: runAiModelPoseGeneration externalDocs: description: AI Model Pose Generation API documentation url: https://www.nexscope.ai/api-docs/ai-model-pose-generation requestBody: required: true content: application/json: schema: type: object description: Generate model pose variations from an input image and either a pose prompt or posture reference image. properties: imageUrl: type: string description: Public URL of the model image. The image must be up to 20 MB and between 385 and 4096 pixels in both width and height. example: https://example.com/model-reference.jpg prompt: type: string description: Text prompt describing the target pose. example: standing naturally with one hand holding the product postureUrl: type: string description: Optional posture reference image URL. example: https://example.com/pose.jpg outputNum: type: integer description: Number of images to generate, from 1 to 4. Defaults to 1. example: 1 required: - imageUrl example: imageUrl: https://example.com/model-reference.jpg prompt: standing naturally with one hand holding the product postureUrl: https://example.com/pose.jpg outputNum: 1 additionalProperties: true example: imageUrl: https://example.com/model-reference.jpg prompt: standing naturally with one hand holding the product postureUrl: https://example.com/pose.jpg outputNum: 1 responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: ai-model-pose-generation x-nexscope-mcp-tool-name: nexscope_ai_model_pose_generation x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/sales-talking-video/run: post: tags: - Multimodal AI summary: Sales Talking Video API description: Create a product-selling video from prompt and product image references. operationId: runSalesTalkingVideo externalDocs: description: Sales Talking Video API documentation url: https://www.nexscope.ai/api-docs/sales-talking-video requestBody: required: true content: application/json: schema: type: object description: Create a product-selling video from prompt and product image references. properties: prompt: type: string description: Sales script or creative prompt. example: Introduce this shockproof phone case in an upbeat tone. imageList: type: array items: type: string description: Public product image URLs. Provide up to 30 images for Seedance 2.5 or up to 9 images for the other supported models. example: - https://example.com/product.jpg minItems: 1 maxItems: 30 videoType: type: string description: 'Video model. Supported values: seedance-2-0, seedance-2-0-fast, seedance-2-0-mini, seedance-2-5, or happyhorse-v2.' example: seedance-2-0-fast videoTime: type: integer description: Target duration in seconds. Seedance 2.0, Fast, Mini, and HappyHorse V2 support 5, 10, or 15; Seedance 2.5 also supports 30. example: 10 aspectRatio: type: string description: 'Target aspect ratio: 16:9, 9:16, 1:1, 4:3, 3:4, or 21:9.' example: '9:16' isPro: type: boolean description: Enable Pro mode for any Seedance model. HappyHorse V2 does not support Pro mode. When enabled without resolution, the default is 720p. example: false resolution: type: string description: Target resolution. Seedance 2.0 and 2.5 support 480p, 720p, or 1080p; Seedance Fast and Mini support 480p or 720p; HappyHorse V2 supports 720p or 1080p. example: 720p required: - prompt - imageList - videoType example: prompt: Introduce this shockproof phone case in an upbeat tone. imageList: - https://example.com/product.jpg videoType: seedance-2-0-fast videoTime: 10 aspectRatio: '9:16' isPro: false resolution: 720p additionalProperties: true example: prompt: Introduce this shockproof phone case in an upbeat tone. imageList: - https://example.com/product.jpg videoType: seedance-2-0-fast videoTime: 10 aspectRatio: '9:16' isPro: false resolution: 720p responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: sales-talking-video x-nexscope-mcp-tool-name: nexscope_sales_talking_video x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/product-logo-detection-removal/run: post: tags: - Multimodal AI summary: Product Logo Detection & Removal API description: Detect and optionally remove a specified brand logo from a product image. operationId: runProductLogoDetectionRemoval externalDocs: description: Product Logo Detection & Removal API documentation url: https://www.nexscope.ai/api-docs/product-logo-detection-removal requestBody: required: true content: application/json: schema: type: object description: Detect and optionally remove a specified brand logo from a product image. properties: imageUrl: type: string description: Public URL of the product image. The image must be up to 20 MB. example: https://example.com/product.jpg brandName: type: string description: Brand name to detect or remove. example: SampleBrand isDetect: type: boolean description: Whether to only detect instead of removing. example: false required: - imageUrl - brandName example: imageUrl: https://example.com/product.jpg brandName: SampleBrand isDetect: false additionalProperties: true example: imageUrl: https://example.com/product.jpg brandName: SampleBrand isDetect: false responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: product-logo-detection-removal x-nexscope-mcp-tool-name: nexscope_product_logo_detection_removal x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true /api/skill-api/v1/skills/one-click-image-recoloring-v2/run: post: tags: - Multimodal AI summary: One-Click Image Recoloring API v2 description: Recolor the requested subject using one or more target colors. operationId: runOneClickImageRecoloringV2 externalDocs: description: One-Click Image Recoloring API v2 documentation url: https://www.nexscope.ai/api-docs/one-click-image-recoloring-v2 requestBody: required: true content: application/json: schema: type: object description: Recolor the requested subject using one or more target colors. properties: imageUrl: type: string description: Public URL of the product image. The image must be between 300 and 4096 pixels in both width and height. example: https://example.com/product.jpg colors: type: array items: type: string description: Target colors, from 1 to 25 entries. Each value must use full HEX (#RRGGBB), HSB (hsb(H, S%, B%)), or RGB (rgb(R, G, B)) format. Provide colors or refImageUrls, but not both. example: - '#000000' - '#FFFFFF' minItems: 1 maxItems: 25 refImageUrls: type: array items: type: string description: Reference image URLs for reference-image recoloring, from 1 to 25 entries. Provide refImageUrls or colors, but not both. example: - https://example.com/color-reference.jpg minItems: 1 maxItems: 25 colorSubject: type: string description: Subject to recolor. example: phone case required: - imageUrl - colorSubject example: imageUrl: https://example.com/product.jpg colors: - '#000000' - '#FFFFFF' colorSubject: phone case additionalProperties: true example: imageUrl: https://example.com/product.jpg colors: - '#000000' - '#FFFFFF' colorSubject: phone case responses: '200': description: Successful response. content: application/json: schema: type: object description: Creates a Nexscope asynchronous generation task. Use taskId with the task result endpoint to retrieve the completed output. The completed result replaces generated resource URLs with Nexscope-hosted URLs and replaces provider count with actual Nexscope credits charged. properties: taskId: type: string description: Nexscope asynchronous task id used to query the generation result. example: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: type: string description: Task status. Initial run returns PENDING; the query endpoint may return PENDING, RUNNING, SUCCESS, FAILED, or TIMEOUT. example: PENDING message: type: string description: User-facing task state message. example: The task has been created. Use taskId to query the result. errcode: type: integer description: Upstream status code returned by the provider. errmsg: type: string description: Upstream status message returned by the provider. code: type: string description: Provider-specific status code. msg: type: string description: Provider-specific status message. type: type: string description: Provider-specific render or payload type. title: type: string description: Provider-specific response title. sourceType: type: string description: Provider-specific source platform type. sourceTool: type: string description: Provider-specific source tool name. costToken: type: integer description: Token cost reported by the upstream provider. costTime: type: integer description: Execution time reported by the upstream provider. page: type: integer description: Current page returned by the upstream provider. pageSize: type: integer description: Page size returned by the upstream provider. pageItemCount: type: integer description: Item count on the current page returned by the upstream provider. totalPage: type: integer description: Total page count returned by the upstream provider. dataSnapshotMonth: type: string description: Data snapshot month returned by the upstream provider. required: - taskId - status example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. additionalProperties: true example: taskId: 6b3f1c61-1b7d-4a59-8a7d-3b23e4b0c9e2 status: PENDING message: The task has been created. Use taskId to query the result. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/ServerError' x-nexscope-slug: one-click-image-recoloring-v2 x-nexscope-mcp-tool-name: nexscope_one_click_image_recoloring_v2 x-nexscope-pricing-mode: dynamic-credits x-nexscope-catalog-derived: true components: responses: ServerError: description: Server or upstream provider error. content: application/json: schema: $ref: '#/components/schemas/CommonError' Forbidden: description: The account or API key is not allowed to use this capability. content: application/json: schema: $ref: '#/components/schemas/CommonError' Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/CommonError' TooManyRequests: description: Rate limit or account usage limit reached. headers: Retry-After: description: Retry delay when returned by the service. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/CommonError' BadRequest: description: Invalid request parameters. content: application/json: schema: $ref: '#/components/schemas/CommonError' schemas: CommonError: type: object description: Common API error envelope. Exact fields may vary by endpoint and upstream provider. properties: code: oneOf: - type: integer - type: string description: Application or provider error code. msg: type: string description: Error message. message: type: string description: Alternative error message field. traceId: type: string description: Support trace identifier when available. additionalProperties: true securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Nexscope API Key externalDocs: description: Nexscope API Documentation url: https://www.nexscope.ai/api-docs x-nexscope-source: https://api.nexscope.ai/api/skill-api/v1/api-docs x-nexscope-pricing-mode: dynamic-credits x-nexscope-mcp-endpoint: https://api.nexscope.ai/api/skill-api/v1/mcp