> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # GPT Image 2.6 Sunburst Image Edit > The GPT Image 2.6 Sunburst Image Edit API edits 1–16 reference images into one 1K–4K image, with optional masks, transparent backgrounds and output compression. > [!TIP] > > 1. After submission, a `task_id` will be returned. If you provided a `callback_url`, when the task status becomes `finished` or `failed`, a POST request will be sent to the `callback_url`. > 2. Regardless of whether `callback_url` is provided, you can retrieve the result through the unified [Query Task Status](https://docs.vidgo.ai/api-manual/task-management/status.md) endpoint. GPT Image 2.6 Sunburst Image Edit edits images from text instructions: send 1–16 reference images to restyle, replace backgrounds, combine products into a new scene, or change only a masked region. Sunburst is the GPT Image 2.6 option for detailed visual work and precision-focused editing. For prompt-only generation, use [GPT Image 2.6 Sunburst Text to Image](https://docs.vidgo.ai/api-manual/image-series/gpt-image-2-6-sunburst-text-to-image.md) (`openai/gpt-image-2.6-sunburst/text-to-image`). GPT Image 2.6 accepts the same parameters as [GPT Image 2.5 Sunburst](https://docs.vidgo.ai/api-manual/image-series/gpt-image-2-5-sunburst-edit.md), plus `output_compression`, `moderation` and `complexity`. ## Models * **openai/gpt-image-2.6-sunburst/edit** — Image edit with GPT Image 2.6 Sunburst, 1–16 reference images, one image per request. ## Features * Instruction-based editing with up to 16 reference images, referenced by order in the prompt. * Optional mask to limit the edit to one region. * Three resolution tiers (`1K`, `2K`, `4K`) with aspect-ratio presets, `auto`, or custom `WIDTHxHEIGHT` sizes. * Five quality tiers: `low`, `medium`, `high`, `xhigh`, `max`. * Transparent or opaque backgrounds; PNG, JPEG or WebP output. * Adjustable JPEG/WebP compression, moderation strictness and planning effort (`complexity`). ## Required parameters * `prompt` (string): Text instructions describing the edit. Up to 32,000 characters; must not be blank. * `image_urls` (string\[]): 1–16 reference images as publicly accessible HTTP(S) URLs, in the order you refer to them in the prompt. ## Optional parameters * `size` (string): Aspect-ratio preset, `auto`, or custom `WIDTHxHEIGHT`. When omitted, the output follows the first reference image's aspect ratio. See [Size](#size). * `resolution` (string): `1K`, `2K` or `4K`. Default `1K`. * `quality` (string): `low`, `medium`, `high`, `xhigh` or `max`. Default `high`. * `background` (string): `auto`, `transparent` or `opaque`. Default `auto`. A transparent background requires `png` or `webp` output. * `output_format` (string): `png`, `jpeg` or `webp`. Default `png`. * `output_compression` (integer): Compression level from `0` to `100`. Only allowed when `output_format` is `jpeg` or `webp`. When omitted, the default compression applies. * `mask_url` (string): Mask image selecting the area to edit, as a publicly accessible HTTP(S) URL. Requires `image_urls`. * `moderation` (string): Content moderation strictness, `auto` or `low`. Default `auto`; `low` applies less restrictive filtering. * `complexity` (string): Planning effort the model spends before generating, `low`, `medium` or `high`. Default `high`. Does not change the price. ## Size * Presets: `1:1`, `2:3`, `3:2`, `4:3`, `3:4`, `4:5`, `5:4`, `16:9`, `9:16`, `21:9`. When `size` is omitted, the output follows the first reference image's aspect ratio, using the closest supported ratio at the selected `resolution`. Send `size` to override it. * Presets keep the selected `resolution` tier; actual pixel dimensions may vary between generations. Use a custom size when you need exact pixels. * `auto` lets the model choose the size (about 1.5 megapixels). It works with any `resolution` and is billed at the `1K` tier. * Custom `WIDTHxHEIGHT` (use `x` or `X`, for example `2304x1536`) works with any `resolution`. Both edges must be multiples of 16, the longest edge must not exceed 3,840 pixels, the aspect ratio must not exceed 3:1, and total pixels must be between 655,360 and 8,294,400. * A custom size is billed at the tier that matches its total pixels, or at the selected `resolution` if that is higher: | Total pixels (custom size) | Billing tier | | - | - | | Up to 1,572,864 | `1K` | | 1,572,865–4,194,304 | `2K` | | Above 4,194,304 | `4K` | ## Examples * **Edit with a reference image**: replace the background at `2K` without `size`, so the output keeps the reference image's aspect ratio. * **Mask edit**: change only the masked area, with `size: auto`. * **Transparent background**: remove the background, WebP, `4K`, `xhigh` quality. * **Custom size**: place the product in a panoramic scene at `2304x1536`, `2K`, `medium` quality. * **Compressed JPEG**: `3:2`, `medium` quality, `output_format: jpeg`, `output_compression: 80`. ## Notes * Each request returns exactly one image; `n` other than `1` returns 400. Fields not listed above return 400. `model` and `callback_url` belong at the request root, not inside `input`. * A transparent background with `output_format: jpeg` returns 400. `output_compression` with `output_format: png` also returns 400. * An empty `image_urls` array, more than 16 images, or a URL that is not a valid HTTP(S) URL returns 400. * Credits depend on `quality`, the billing tier (`resolution`, or the custom-size tier described in [Size](#size)) and the number of reference images. `complexity` and `moderation` do not change the price. The per-image maximum is reserved at submission; when the task finishes you are charged for actual token usage, up to that maximum, and the rest is refunded. A failed task is refunded in full. See the [pricing page](https://vidgo.ai/apis/api-pricing) for current rates. ## OpenAPI ````yaml api-manual/image-series/gpt-image-2-6-sunburst-edit.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - GPT Image 2.6 Sunburst Image Edit description: >- The GPT Image 2.6 Sunburst Image Edit API edits 1–16 reference images into one 1K–4K image, with optional masks, transparent backgrounds and output compression. version: 1.0.0 servers: - url: https://api.vidgo.ai description: Production server security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - GPT Image 2.6 Sunburst Image Edit summary: Submit GPT Image 2.6 Sunburst Image Edit Task operationId: submitGPTImage26SunburstImageEditTask requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/SubmitRequest' examples: reference-edit: summary: Edit with reference images value: model: openai/gpt-image-2.6-sunburst/edit input: prompt: >- Preserve the product and replace the background with a warm modern studio. image_urls: - https://cdn.vidgo.ai/temp/reference-product.png resolution: 2K mask-edit: summary: Edit a masked region value: model: openai/gpt-image-2.6-sunburst/edit input: prompt: Replace the masked area with a small vase of flowers. image_urls: - https://cdn.vidgo.ai/temp/reference-product.png mask_url: https://cdn.vidgo.ai/temp/edit-mask.png size: auto transparent-background: summary: Edit an image with a transparent background value: model: openai/gpt-image-2.6-sunburst/edit input: prompt: Keep the silver robot and remove its background. background: transparent output_format: webp resolution: 4K quality: xhigh image_urls: - https://cdn.vidgo.ai/temp/reference-product.png custom-size: summary: Edit with custom dimensions value: model: openai/gpt-image-2.6-sunburst/edit input: prompt: >- Preserve the product and place it in a panoramic city garden. size: 2304x1536 resolution: 2K quality: medium image_urls: - https://cdn.vidgo.ai/temp/reference-product.png compressed-jpeg: summary: Compressed JPEG output value: model: openai/gpt-image-2.6-sunburst/edit input: prompt: >- Place the product on a linen tablecloth with soft window light. size: '3:2' quality: medium output_format: jpeg output_compression: 80 image_urls: - https://cdn.vidgo.ai/temp/reference-product.png responses: '200': description: >- Task submission result. A task ID identifies asynchronous work; generation may still be running. content: application/json: schema: $ref: '#/components/schemas/SubmitResponse' '400': description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: SubmitRequest: type: object required: - model - input additionalProperties: false properties: model: type: string example: openai/gpt-image-2.6-sunburst/edit callback_url: type: string format: uri description: Optional webhook URL for completion or failure notifications. example: https://your-domain.com/callback input: type: object required: - prompt - image_urls additionalProperties: false properties: prompt: type: string minLength: 1 maxLength: 32000 description: |- Text instructions describing the edit. Include at least one non-whitespace character. size: type: string description: >- Output aspect-ratio preset, auto, or custom WIDTHxHEIGHT. When omitted, the output follows the first reference image's aspect ratio (closest supported ratio at the selected resolution). Presets: `1:1`, `2:3`, `3:2`, `4:3`, `3:4`, `4:5`, `5:4`, `16:9`, `9:16`, `21:9`. `auto` lets the model choose the size at any resolution and is billed at 1K. Custom sizes work at any resolution: both edges multiples of 16, maximum edge 3840, aspect ratio at most 3:1, and 655360–8294400 total pixels. Use `x` or `X` between width and height. They are billed at the tier matching total pixels (up to 1572864 is 1K, up to 4194304 is 2K, larger is 4K), or the selected resolution if it is higher. resolution: type: string enum: - 1K - 2K - 4K default: 1K description: Output resolution tier. image_urls: type: array maxItems: 16 items: type: string format: uri description: Use a publicly accessible HTTP(S) download URL. description: Required reference images for editing, in prompt order. minItems: 1 output_format: type: string enum: - png - jpeg - webp default: png description: |- Output image format. Transparent output requires PNG or WebP. output_compression: type: integer minimum: 0 maximum: 100 description: >- Compression level for the output image, from 0 to 100. Only allowed when output_format is jpeg or webp; any other format returns 400. When omitted, the default compression applies. quality: type: string enum: - low - medium - high - xhigh - max default: high description: |- Image quality tier. Billing depends on quality and the billing tier. background: type: string enum: - auto - transparent - opaque default: auto description: |- Background mode. Transparent output requires PNG or WebP. mask_url: type: string format: uri description: |- Optional mask selecting the area to edit. Requires at least one reference image. Use a publicly accessible HTTP(S) download URL. moderation: type: string enum: - auto - low default: auto description: |- Content moderation strictness. low applies less restrictive filtering. complexity: type: string enum: - low - medium - high default: high description: |- Planning effort the model spends before generating. Does not change the price. SubmitResponse: type: object required: - code - data properties: code: type: integer example: 200 data: type: object required: - task_id - status - created_time properties: task_id: type: string example: task-example-001 status: type: string example: not_started created_time: type: string format: date-time example: '2026-10-09T10:30:00' ErrorResponse: type: object required: - detail properties: detail: type: string description: Error message. See [Error Codes](/api-manual/error-codes). example: prompt is required securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: 'Use `Authorization: Bearer VIDGO_API_KEY`.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.