by OpenAI

Create & Edit up to 4K

openai/gpt-image-2.6-sunburst/edit
  • Up to 4K
  • Up to 16 reference images
  • 15 aspect ratios
  • Up to 10 per run
  • Create Image
  • Edit Image

About GPT Image 2.6 Sunburst

GPT Image 2.6 Sunburst is the precision tier of OpenAI's GPT Image 2.6, built for fidelity and details that hold steady across repeated edits. It makes images in five quality levels from low to max and sizes up to 4K, edits with up to 16 pictures, and can turn a prompt into a short looping GIF. Compared with GPT Image 2.5 it adds GIF output, a marked-up copy as an edit guide, transparent backgrounds when making images from text, and an optional reasoning effort setting.

Call it with the model name openai/gpt-image-2.6-sunburst/edit on POST /jobs/createTask, from $0.02232.

Introduction

GPT Image 2.6 Sunburst Image Editing changes a supplied picture using a written instruction. The precision tier focuses on fidelity and steady details through repeated revisions, with room for 1–16 input images.

Place the picture to revise first and explain the role of each additional reference. An optional PNG mask marks a repaint region; in our tests, an outfit and location change retained the person’s appearance.

Key features

  • Numbered references: call sources Image 1, Image 2 and later numbers to explain what each contributes.
  • Local repainting: transparent pixels in a same-size PNG mask identify the area to change in the first source.
  • Shape preservation: omitting aspect_ratio keeps the first image’s shape at 1k; 2k and 4k require a selected ratio.
  • Flexible delivery: save revisions as PNG, JPEG or WebP, with transparency supported in PNG and WebP.

Request parameters

ParameterRequiredDescription
aspect_ratioNoThe shape of the frame: wide, square or tall. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · 2:1 · 1:2 · 3:1 · 1:3 · 5:4 · 4:5
backgroundNoKeep, remove or replace the background. auto · transparent · opaque · Default: auto
image_urlsYesPhotos to edit or combine. Say in the prompt what each one adds.
markup_urlNoUpload a copy of the photo with circles or arrows drawn on it to show what to change. Use this or a mask, not both.
mask_urlNoPaint over the area that should change.
num_outputsNoHow many results to make in one go. ≥ 1 · ≤ 10 · Default: 1
output_formatNoFile type of the result. png · jpeg · webp · Default: png
output_qualityNoCompression for JPEG and WebP. Higher keeps more detail and makes bigger files. ≥ 0 · ≤ 100
promptYesDescribe what you want to make.
qualityNoChoose one of this model’s quality settings. low · medium · high · xhigh · max · Default: medium
reasoning_effortNoReasoning effort for the spoken response; reasoning consumes output tokens. low · medium · high
resolutionNoChoose an available output size. 1k · 2k · 4k · Default: 1k

Pricing

Prices are in USD. The API uses a separate USD balance. Website credits cannot be used or transferred to it, and API funds cannot be transferred to website credits. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.

OptionUSD per image
quality low · resolution 1K$0.02232
quality medium · resolution 1K$0.03915
quality low · resolution 2K$0.04131
quality high · resolution 1K$0.04743
quality medium · resolution 2K$0.07299
quality low · resolution 4K$0.07479
quality xhigh · resolution 1K$0.08433
quality high · resolution 2K$0.08847
quality medium · resolution 4K$0.13221
quality xhigh · resolution 2K$0.15723
quality high · resolution 4K$0.16011
quality max · resolution 1K$0.18972

Billed on the tokens each request uses: $4.50 per 1M text input tokens, $7.20 per 1M image input tokens and $27.00 per 1M image output tokens. The table lists the square-image price for each tier, so other ratios usually cost less. With several output images, input tokens count once per image.

Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.

Use cases

  • Wardrobe revision: turn a supplied portrait into a camel trench coat scene for a campaign concept.
  • Location change: move an existing subject to a rainy Paris street while describing what should remain.
  • Localized artwork correction: mark a poster region with a mask and request a replacement background detail.

Prompt guide & pro tips

  • Name the source: start with “Image 1 is the portrait to revise” so the instruction identifies its base.
  • Describe continuity: add “keep the person’s appearance” before describing a new outfit or setting.
  • Assign reference roles: write “use the color palette from Image 2” when adding another input.
  • Describe the masked replacement: try “replace the marked wall with teal paint” with a matching PNG mask.
  • State the new setting precisely: use “rainy Paris street at blue hour” to define place and lighting together.

API quick start

Call the GPT Image 2.6 Sunburst API in three steps

  1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow-. API calls use your separate USD balance.
  2. Send the request. POST /jobs/createTask with model openai/gpt-image-2.6-sunburst/edit and an input object that follows the parameter table. The response returns a task ID straight away.
  3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "openai/gpt-image-2.6-sunburst/edit",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "resolution": "1k",
    "quality": "medium",
    "num_outputs": 1,
    "background": "auto",
    "output_format": "png"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

GPT Image 2.6 Sunburst API questions

How much does the GPT Image 2.6 Sunburst API cost?

GPT Image 2.6 Sunburst starts at $0.02232 per image with Edit Image, its cheapest task. Prices by option: low · 1K $0.02232 per image, medium · 1K $0.03915 per image, low · 2K $0.04131 per image, high · 1K $0.04743 per image. The API uses a separate USD balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.

What are the limits of the GPT Image 2.6 Sunburst · Edit Image API?

Resolutions: 1K · 2K · 4K; Aspect ratios: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +9; Outputs per call: 1–10; Reference images: 16; Prompt length (characters): 5,000. Requests outside these limits are rejected before anything is charged.

More about GPT Image 2.6 Sunburst