# GPT Image 2.5 Sunburst

> OpenAI's most capable image model, built for workflows where editing precision matters most. Generate and edit images from text and image inputs with strong instruction following, sharp text rendering, and detailed control.

- **Provider**: replicate
- **Model ID**: openai/gpt-image-2.5-sunburst
- **Category**: image_generation
- **Credits**: 580 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `openai_api_key` (string, optional): Your OpenAI API key (optional - uses proxy if not provided)
- `aspect_ratio` (string, optional): The size of the generated image. Use 'auto' to let the model pick. Sizes above 2560x1440 are experimental and may give more variable results. (Default: `1:1`; Options: `1:1`, `3:2`, `2:3`, `4:3`, `3:4`, `16:9`, `9:16`, `auto`, `1024x1024`, `1536x1024`, `1024x1536`, `1536x1152`, `1152x1536`, `2048x2048`, `2048x1152`, `1152x2048`, `3840x2160`, `2160x3840`)
- `input_images` (array, optional): A list of images to use as input for the generation
- `number_of_images` (integer, optional): Number of images to generate (1-10) (Default: `1`; Range: min: 1, max: 10)
- `output_format` (string, optional): Output format (Default: `webp`; Options: `png`, `jpeg`, `webp`)
- `output_compression` (integer, optional): Compression level (0-100%) (Default: `90`; Range: min: 0, max: 100)
- `user_id` (string, optional): An optional unique identifier representing your end-user. This helps OpenAI monitor and detect abuse.
- `background` (string, optional): Set whether the background is transparent or opaque or choose automatically (Default: `auto`; Options: `auto`, `transparent`, `opaque`)
- `moderation` (string, optional): Content moderation level (Default: `auto`; Options: `auto`, `low`)
- `prompt` (string, **required**): A text description of the desired image
- `quality` (string, optional): The quality of the generated image. Higher quality takes longer and costs more. (Default: `auto`; Options: `low`, `medium`, `high`, `xhigh`, `max`, `auto`)

## Example Request

```json
{
  "model": "openai/gpt-image-2.5-sunburst",
  "input": {
    "aspect_ratio": "1:1",
    "number_of_images": 1,
    "output_format": "webp",
    "prompt": "A golden retriever puppy wearing tiny sunglasses on a sunny beach, photorealistic, shallow depth of field",
    "quality": "high"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

image-generation, text-to-image, image-editing, openai, typography, photorealistic, text-rendering, character-consistency, frontier

## Documentation

https://replicate.com/openai/gpt-image-2.5-sunburst