Multimodal AI

White Background Product Image API

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.

post/api/skill-api/v1/skills/whitebg-image/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/whitebg-image/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

imageListstring[] required

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.

promptstring required

Describe one target supported by the references, up to 350 characters. Output is fixed to one 1:1 image.

Example request

{
  "imageList": [
    "https://example.com/product.jpg"
  ],
  "prompt": "Show the complete product from the supplied front view."
}

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.