Image Generation Models

GPT Image 2.5 Sunburst

Create and edit ecommerce visuals with precise instruction following, broad visual-style support, world-knowledge grounding, and reliable text rendering through the GPT Image 2.5 Sunburst route. The model is fixed by this API, so provider must not be supplied in the request.

post/api/skill-api/v1/skills/gpt-image-2-5-generation/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/gpt-image-2-5-generation/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

imageUrlsstring[]

Optional public reference image URLs. Omit this field for text-to-image generation, or provide references for image-to-image generation. When supplied, provide 1 to 10 JPG, PNG, or WEBP images; each image must not exceed 20 MB.

promptstring required

Generation prompt describing the target image, scene, composition, style, and constraints. Maximum 5000 characters.

outputNuminteger

Number of images to generate. Valid range: 1 to 10; defaults to 1.

resolution'1K' | '2K' | '4K'

Output resolution. Supported values: 1K, 2K, or 4K; defaults to 2K.

aspectRatio'1:1' | '3:4' | '4:3' | '2:3' | '3:2' | '9:16' | '16:9' | '4:5' | '5:4' | '21:9' | '9:21'

Output aspect ratio. Supported values: 1:1, 3:4, 4:3, 2:3, 3:2, 9:16, 16:9, 4:5, 5:4, 21:9, 9:21.

quality'low' | 'medium' | 'high' | 'xhigh' | 'max'

GPT Image quality. Supported values: low, medium, high, xhigh, max. Defaults to medium.

Example request

{
  "imageUrls": [],
  "prompt": "Keep the product consistent and generate a clean white-background ecommerce hero image.",
  "outputNum": 1,
  "resolution": "2K",
  "aspectRatio": "1:1",
  "quality": "medium"
}

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.