> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkmodel.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# gpt-image-2.5-sunburst

> A precision-focused visual generation and editing model supporting multiple references, mask-guided changes, custom dimensions, and transparent backgrounds for demanding creative production.



## OpenAPI

````yaml /openapi/image/gpt-image-2-5-sunburst.yaml post /images/generations
openapi: 3.0.3
info:
  title: gpt-image-2.5-sunburst
  version: 1.0.0
  description: >-
    A precision-focused visual generation and editing model supporting multiple
    references, mask-guided changes, custom dimensions, and transparent
    backgrounds for demanding creative production.
  x-linkmodel-sort-weight: 99202609099
servers:
  - url: https://api.linkmodel.ai/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: OpenAI
  - name: image
paths:
  /images/generations:
    post:
      tags:
        - OpenAI
        - image
      summary: gpt-image-2.5-sunburst
      description: >
        A precision-focused visual generation and editing model supporting
        multiple references, mask-guided changes, custom dimensions, and
        transparent backgrounds for demanding creative production.


        |   |   |

        | --- | --- |

        | **Provider** | OpenAI |

        | **Tasks** | text-to-image · image-to-image |

        | **Starting from** | 0.9375 USD / token · <a
        href="https://linkmodel.ai/en/models/gpt-image-2.5-sunburst"
        target="_blank" rel="noopener">Pricing details</a> |


        ## Task lifecycle


        This endpoint creates an asynchronous task. Poll `GET
        /images/generations/{task_id}` with the returned `task_id` until the
        task reaches a terminal state.


        If the POST request times out or its result is uncertain, do not blindly
        retry it. The original request may already have created another task and
        billing order.


        Completed asset URLs are dynamically signed. Download or copy assets
        that must be retained instead of treating the URLs as permanent
        identifiers.
      operationId: gpt-image-2-5-sunburst
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  enum:
                    - gpt-image-2.5-sunburst
                  default: gpt-image-2.5-sunburst
                  description: >-
                    Must be one of: gpt-image-2.5-sunburst. Defaults to
                    `gpt-image-2.5-sunburst`.
                prompt:
                  type: string
                  minLength: 1
                  maxLength: 32000
                  description: Length must be between 1 and 32000.
                images:
                  type: array
                  minItems: 1
                  maxItems: 16
                  items:
                    type: string
                    format: url
                  description: Upload 1 to 16 reference images for image editing.
                extends.edit.mask:
                  type: string
                  format: url
                  description: >-
                    Optional mask for local editing; transparent areas are
                    regenerated.


                    This field's allowed values depend on: images.
                size:
                  type: string
                  default: auto
                  description: >-
                    Each side <= 3840, both sides multiples of 16, ratio <= 3:1,
                    total pixels 655360 to 8294400. Defaults to `auto`.
                quality:
                  type: string
                  enum:
                    - auto
                    - high
                    - low
                    - max
                    - medium
                    - xhigh
                  default: auto
                  description: >-
                    Must be one of: auto, high, low, max, medium, xhigh.
                    Defaults to `auto`.
                max_images:
                  type: integer
                  default: 1
                  minimum: 1
                  maximum: 10
                  description: Must be between 1 and 10. Defaults to `1`.
                output_format:
                  type: string
                  enum:
                    - jpeg
                    - png
                    - webp
                  default: png
                  description: 'Must be one of: jpeg, png, webp. Defaults to `png`.'
                output_compression:
                  type: integer
                  minimum: 0
                  maximum: 100
                  description: >-
                    Only valid when output_format is jpeg or webp. Value is in
                    %.


                    This field's allowed values depend on: output_format.
                background:
                  type: string
                  enum:
                    - auto
                    - opaque
                    - transparent
                  default: auto
                  description: >-
                    Must be one of: auto, opaque, transparent. Defaults to
                    `auto`.


                    **Conditional limits:**

                    - transparent background requires png or webp output_format
                moderation:
                  type: string
                  enum:
                    - auto
                    - low
                  default: auto
                  description: 'Must be one of: auto, low. Defaults to `auto`.'
              required:
                - model
                - prompt
      responses:
        '200':
          description: >-
            Business response. `code=0` means the task was accepted; validation
            failures can return HTTP 200 with `code=400`.
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    required:
                      - code
                      - data
                      - msg
                    properties:
                      code:
                        type: integer
                        enum:
                          - 0
                        example: 0
                      data:
                        type: object
                        required:
                          - task_id
                        properties:
                          task_id:
                            type: string
                            description: Use this id to poll task status.
                            example: aurora_abc123
                          order_id:
                            type: string
                            description: Billing order id.
                            example: 019da9cf-d1db-78e1-ac23-526774d01193
                          status:
                            type: string
                            example: Processing
                          price:
                            type: number
                            description: Charged amount in the model's pricing currency.
                            example: 0.074
                      msg:
                        type: string
                        example: success
                      request_id:
                        type: string
                        format: uuid
                        example: 250b66dd-e1fb-4bb6-b5f6-c668efadc35d
                  - type: object
                    required:
                      - code
                      - msg
                    properties:
                      code:
                        type: integer
                        enum:
                          - 400
                        example: 400
                      data:
                        type: object
                        example: {}
                      msg:
                        type: string
                        example: model is required
                      request_id:
                        type: string
                        format: uuid
                        example: 96be7a7d-3e81-4916-a6b8-19b32773a693
        '400':
          description: >-
            Malformed HTTP request rejected by the Gateway. Model and parameter
            validation may instead use HTTP 200 with business `code=400`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    example: 400
                  msg:
                    type: string
                    example: task_id is required
                  request_id:
                    type: string
                    format: uuid
                    example: 96be7a7d-3e81-4916-a6b8-19b32773a693
        '401':
          description: Unauthorized — missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    example: 401
                  data:
                    type: object
                    example: {}
                  msg:
                    type: string
                    example: invalid api key
                  request_id:
                    type: string
                    format: uuid
                    example: bff4c295-c7da-4507-9708-4627cb6373ba
        '500':
          description: Internal error — task creation failed (e.g. insufficient balance).
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    example: 500
                  msg:
                    type: string
                    example: >-
                      create task failed: billing: code=100601: insufficient
                      balance
                  request_id:
                    type: string
                    format: uuid
                    example: 3409f6fb-fa9a-4534-b530-195b5f6f4e32
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````