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

# GPT Image 2.5 Sunburst Edit

> [Core Function] GPT Image 2.5 Sunburst Edit is a quality-oriented image editing model. [Strengths] Supports up to 16 input images, optional mask-based local edits, resolution tiers up to 4K, and transparent backgrounds. [Best For] Product image changes, masked object replacements, and edits guided by multiple reference images. [Limitations] Do NOT use this for editing more than 16 input images or selecting arbitrary pixel dimensions. Exact input fidelity control is not exposed. [Routing] Choose this variant when image quality is the priority; use GPT Image 2.5 Flare Edit when speed is the priority.



## OpenAPI

````yaml /media-model-api/openai/openai-i2i.json post /openai/gpt-image-2.5-sunburst-edit
openapi: 3.1.0
info:
  description: The image-to-image (image editing) models API from OpenAI.
  version: 1.0.0
  contact:
    name: Modellix Support
    email: support@modellix.ai
  title: OpenAI Image-to-Image Models API
servers:
  - url: https://api.modellix.ai/api/v1
    description: The image-to-image models API from OpenAI.
security:
  - bearerAuth: []
paths:
  /openai/gpt-image-2.5-sunburst-edit:
    post:
      tags:
        - GPT Image Edit
      summary: GPT Image 2.5 Sunburst Edit
      description: >-
        [Core Function] GPT Image 2.5 Sunburst Edit is a quality-oriented image
        editing model. [Strengths] Supports up to 16 input images, optional
        mask-based local edits, resolution tiers up to 4K, and transparent
        backgrounds. [Best For] Product image changes, masked object
        replacements, and edits guided by multiple reference images.
        [Limitations] Do NOT use this for editing more than 16 input images or
        selecting arbitrary pixel dimensions. Exact input fidelity control is
        not exposed. [Routing] Choose this variant when image quality is the
        priority; use GPT Image 2.5 Flare Edit when speed is the priority.
      operationId: gptImage25SunburstEditAsync
      requestBody:
        description: Request payload for GPT Image 2.5 Sunburst Edit.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GPTImage25EditRequest'
            examples:
              basic:
                summary: Basic image editing
                value:
                  images:
                    - https://example.com/input.png
                  prompt: Add a watercolor effect to this image
              masked_edit:
                summary: Edit a masked region
                value:
                  images:
                    - https://example.com/input.png
                  prompt: Replace the red square with a green circle
                  mask: https://example.com/mask.png
                  aspect_ratio: '4:5'
                  resolution: 1K
                  quality: high
      responses:
        '200':
          description: >-
            Task submitted successfully. Poll the URL in data.get_result.url
            using [Query Task Result](/api/get-task-result) to retrieve the
            generated image.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsyncTaskResponse'
              example:
                code: 0
                message: success
                data:
                  status: pending
                  task_id: 12345678-1234-4234-8234-123456789abc
                  model_id: openai/gpt-image-2.5-sunburst-edit
                  get_result:
                    method: GET
                    url: >-
                      https://api.modellix.ai/api/v1/tasks/12345678-1234-4234-8234-123456789abc
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    GPTImage25EditRequest:
      description: Request payload shared by GPT Image 2.5 Sunburst Edit and Flare Edit.
      type: object
      required:
        - images
        - prompt
      additionalProperties: false
      properties:
        prompt:
          type: string
          description: >-
            Description of the desired edits, from 1 to 32,000 Unicode
            characters.
          minLength: 1
          maxLength: 32000
          example: Replace the red square with a green circle
        images:
          type: array
          description: Input image URLs as a string array, with 1 to 16 images.
          minItems: 1
          maxItems: 16
          items:
            type: string
            format: uri
            minLength: 1
          example:
            - https://example.com/input.png
        mask:
          type: string
          format: uri
          minLength: 1
          description: >-
            Optional PNG mask URL for local editing. The mask must have an alpha
            channel and match the first input image's dimensions. Transparent
            areas indicate the area to edit.
          example: https://example.com/mask.png
        aspect_ratio:
          type: string
          description: >-
            Output aspect ratio. Can be set independently of resolution;
            omitting it uses 1:1.
          default: '1:1'
          enum:
            - '1:1'
            - '3:2'
            - '2:3'
            - '3:4'
            - '4:3'
            - '4:5'
            - '5:4'
            - '9:16'
            - '16:9'
            - '21:9'
          example: '16:9'
        resolution:
          type: string
          description: >-
            Output resolution tier. Can be set independently of aspect_ratio;
            omitting it uses 1K. Pixel dimensions depend on both parameters: 1:1
            + 1K gives 1024x1024, 1:1 + 4K gives 2880x2880, and 16:9 + 4K gives
            3840x2160.
          default: 1K
          enum:
            - 1K
            - 2K
            - 4K
          example: 4K
        quality:
          type: string
          description: Output quality level. Defaults to low.
          default: low
          enum:
            - low
            - medium
            - high
            - xhigh
            - max
          example: high
        background:
          type: string
          description: >-
            Background mode: auto lets the model choose, opaque requests an
            opaque background, and transparent requests a transparent background
            with PNG output.
          default: auto
          enum:
            - auto
            - opaque
            - transparent
          example: transparent
    AsyncTaskResponse:
      description: Response object for asynchronous task submission.
      type: object
      required:
        - code
        - message
        - data
      properties:
        code:
          type: integer
          description: Response code, 0 indicates success
          example: 0
        message:
          type: string
          description: Response message
          example: success
        data:
          description: Detailed data about the submitted asynchronous task.
          type: object
          required:
            - status
            - task_id
            - model_id
          properties:
            status:
              type: string
              description: Task status
              enum:
                - pending
                - processing
                - completed
                - failed
              example: pending
            task_id:
              type: string
              description: Unique task identifier for status polling
              example: task_abc123xyz
            model_id:
              type: string
              description: Model identifier used for this task
              example: gpt-image-2-edit
    ErrorResponse:
      description: Standard error response object.
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: integer
          description: Error code
          example: 400
        message:
          type: string
          description: Error message
          example: Invalid request parameters
        details:
          type: object
          description: Additional error details
          additionalProperties: true
  responses:
    BadRequest:
      description: Invalid request parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Authentication required or invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    TooManyRequests:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````