> ## 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 Text to Image

> The GPT Image 2.6 Sunburst Text to Image API turns a prompt into one 1K, 2K or 4K image, with transparent backgrounds, output compression and moderation control.

> [!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 Text to Image generates one image from a text prompt, from quick product shots to transparent assets and exact-pixel layouts at 1K, 2K or 4K. Sunburst is the GPT Image 2.6 option for detailed visual work and precision-focused editing.

For reference-image editing, use [GPT Image 2.6 Sunburst Image Edit](https://docs.vidgo.ai/api-manual/image-series/gpt-image-2-6-sunburst-edit.md) (`openai/gpt-image-2.6-sunburst/edit`). 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-text-to-image.md), plus `output_compression`, `moderation` and `complexity`.

## Models

* **openai/gpt-image-2.6-sunburst/text-to-image** — Text to image with GPT Image 2.6 Sunburst, one image per request.

## Features

* Text-to-image from a prompt of up to 32,000 characters.
* 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 describing the desired image. Up to 32,000 characters; must not be blank.

## Optional parameters

* `size` (string): Aspect-ratio preset, `auto`, or custom `WIDTHxHEIGHT`. Default `1:1`. 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.
* `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 is `1:1` at the selected `resolution`.
* 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

* **Generate one image**: a studio product photo, `1:1`, `1K`, with a `callback_url`.
* **Transparent asset**: a cutout with `background: transparent`, WebP, `4K`, `xhigh` quality.
* **Custom size**: 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.
* Credits depend on `quality` and the billing tier (`resolution`, or the custom-size tier described in [Size](#size)). `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-text-to-image.json POST /api/generate/submit
openapi: 3.0.0
info:
  title: Vidgo API - GPT Image 2.6 Sunburst Text to Image
  description: >-
    The GPT Image 2.6 Sunburst Text to Image API turns a prompt into one 1K, 2K
    or 4K image, with transparent backgrounds, output compression and moderation
    control.
  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 Text to Image
      summary: Submit GPT Image 2.6 Sunburst Text to Image Task
      operationId: submitGPTImage26SunburstTexttoImageTask
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitRequest'
            examples:
              default:
                summary: Generate one image
                value:
                  model: openai/gpt-image-2.6-sunburst/text-to-image
                  callback_url: https://your-domain.com/callback
                  input:
                    prompt: >-
                      A product photograph of a silver coffee maker in a bright
                      studio.
                    size: '1:1'
                    resolution: 1K
              transparent-background:
                summary: Create a transparent asset
                value:
                  model: openai/gpt-image-2.6-sunburst/text-to-image
                  input:
                    prompt: A clean cutout of a small silver robot.
                    background: transparent
                    output_format: webp
                    resolution: 4K
                    quality: xhigh
              custom-size:
                summary: Generate with custom dimensions
                value:
                  model: openai/gpt-image-2.6-sunburst/text-to-image
                  input:
                    prompt: A panoramic city garden with soft morning light.
                    size: 2304x1536
                    resolution: 2K
                    quality: medium
              compressed-jpeg:
                summary: Compressed JPEG output
                value:
                  model: openai/gpt-image-2.6-sunburst/text-to-image
                  input:
                    prompt: >-
                      A ceramic coffee cup on a linen tablecloth, soft window
                      light
                    size: '3:2'
                    quality: medium
                    output_format: jpeg
                    output_compression: 80
      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/text-to-image
        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
          additionalProperties: false
          properties:
            prompt:
              type: string
              minLength: 1
              maxLength: 32000
              description: |-
                Text describing the desired image.

                Include at least one non-whitespace character.
            size:
              type: string
              description: >-
                Output aspect-ratio preset, auto, or custom WIDTHxHEIGHT.


                Defaults to 1:1.


                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.
              default: '1:1'
            resolution:
              type: string
              enum:
                - 1K
                - 2K
                - 4K
              default: 1K
              description: Output resolution tier.
            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.
            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.