Multimodal AI

AI Background Generator API

Create product or lifestyle scene images from text prompts and optional reference images.

post/api/skill-api/v1/skills/ai-background-generator/run

Request

Base URL: https://api.nexscope.ai
URL: https://api.nexscope.ai/api/skill-api/v1/skills/ai-background-generator/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

promptstring required

Text prompt describing the desired scene.

imageUrlstring

Optional reference image URL.

stylestring

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.

scalestring

Output aspect ratio. Supported values: 1:1, 16:9, 9:16. Defaults to 1:1.

outputNuminteger

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

Example request

{
  "prompt": "a premium phone case on a clean marble desk",
  "imageUrl": "https://example.com/product.jpg",
  "style": "scene-material",
  "scale": "1:1",
  "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.