GPT Image 2.5 Sunburst

client.images.generate(params)

POST/v1/images/generations

Generate images with the provider-compatible OpenAI Images API. This synchronous endpoint returns image data directly.

Request body

Use the native OpenAI Images request shape. The model must be gpt-image-2.5-sunburst.

ImageGenerateParams

stringmodelrequired

Use gpt-image-2.5-sunburst on this endpoint.

Default: gpt-image-2.5-sunburst

stringpromptrequired

Text description of the image to generate.

Optional<integer>n

Number of images to generate when supported.

Optional<string>size

Output dimensions supported by the model.

Optional<string>quality

Output quality such as low

Optional<string>background

Background setting such as transparent

Optional<string>output_format

Output encoding such as png

Optional<integer>output_compression

Output compression level from 0 to 100.

Optional<string>moderation

Provider-compatible moderation setting.

Optional<string>user

Provider-compatible end-user identifier.

curl https://api.sandbase.ai/v1/images/generations \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2.5-sunburst","prompt":"A cinematic glass pavilion beside a black-sand beach","size":"1536x1024"}'

Response200 OK

{
  "created": 1787529600,
  "data": [
    {
      "b64_json": "iVBORw0KGgo..."
    }
  ],
  "usage": {
    "input_tokens": 12,
    "output_tokens": 4096,
    "total_tokens": 4108
  }
}

Native protocol notes

GPT Image 2.5 Sunburst prioritizes visual fidelity and precision for complex image generation and editing workflows. It uses the OpenAI Images API contract, not the general SandBase /v1/run model endpoint. Requests are synchronous and return image data in data as b64_json or a URL.

Use the shared image generation reference for authentication, response details, limits, and error handling. The SandBase native catalog entries are openai/gpt-image-2.5-sunburst-official and openai/gpt-image-2.5-sunburst-official/edit; send the public model name gpt-image-2.5-sunburst in native requests.

Edit images

Send edits to POST /v1/images/edits as multipart/form-data. Provide model, prompt, and at least one image file. Repeat the image field to compose or edit multiple source images.

bash

curl https://api.sandbase.ai/v1/images/edits \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "prompt=Preserve the subject and replace the background with a precise architectural studio" \
  -F "image=@portrait.png" \
  -F "quality=high"

See the shared image editing reference for the multipart request and response schema. To use the general asynchronous /v1/run contract instead, see openai/gpt-image-2.5-sunburst/edit.

Request body

Native protocol notes ​

Edit images ​

Official OpenAI resources ​

Native protocol notes

Edit images

Official OpenAI resources