Multimodal AI

Similar Image Variations API

Generate similar ecommerce images from a reference image with optional prompt and strength controls.

post/api/skill-api/v1/skills/similar-image-variations/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/similar-image-variations/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

imageUrlstring required

Public URL of a JPG, PNG, or WEBP reference image up to 10 MB and at most 4096 pixels in both width and height.

promptstring

Optional prompt for the desired variation, up to 600 characters.

weightinteger

Reference image weight from 0 to 2. Defaults to 2.

widthinteger

Desired output width in pixels, from 384 to 4096.

heightinteger

Desired output height in pixels, from 384 to 4096.

scalestring

Optional aspect ratio. Provide scale or both width and height.

outputNuminteger

Number of images to generate, from 1 to 4. Defaults to 4.

Example request

{
  "imageUrl": "https://example.com/product.jpg",
  "prompt": "same product, brighter background",
  "weight": 2,
  "width": 1024,
  "height": 1024,
  "outputNum": 4
}

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.