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

# Image Creation

> Call the Image Generation model to generate images based on text prompts. Supports Text-to-Image, Image-to-Image, multi-image fusion, batch sequential generation, and other modes.

**Model Capabilities**

**Seedream 5.0 pro**
- Generate single image (does not support sequential_image_generation)
- Multi-Image Generation: Input multiple reference images (2-10) + text prompt to generate a single image.
- Single Image Generation: Input single reference image + text prompt to generate a single image.
- Text-to-Image: Input text prompt to generate a single image.
- Interactive Editing: Support specifying editing positions through coordinates, bounding boxes, arrows, and other methods for precise image editing.
- Sequential image generation, web search, and streaming output are not supported.

**Seedream 5.0, Seedream 4.5 / 4.0**
- Generate sequential images (Sequential images: A set of content-related images generated based on your input; requires sequential_image_generation set to auto)
  - Multi-image to sequential: Generate a set of content-related images based on multiple reference images (2-14) + text prompt (number of input reference images + number of final generated images ≤ 15)
  - Single image to sequential: Generate a set of content-related images based on a single reference image + text prompt (up to 14 images)
  - Text to sequential: Generate a set of content-related images based on text prompt (up to 15 images)
- Generate single image (set sequential_image_generation to disabled)
  - Multi Image-to-Image: Generate a single image based on multiple reference images (2-14) + text prompt
  - Single Image-to-Image: Generate a single image based on a single reference image + text prompt
  - Text-to-Image: Generate a single image based on text prompt



## OpenAPI

````yaml api-reference/en/zmodelImage/byteplus/seedream/seedream-image-create.json POST /byteplus/api/v3/images/generations
openapi: 3.0.1
info:
  title: Image Generation API
  version: 1.0.0
  description: >-
    This article describes the API for calling Image Generation models such as
    Seedream 5.0 pro, Seedream 5.0, Seedream 4.5, and Seedream 4.0, including
    input/output parameters, value ranges, notes, etc., for your reference when
    using the interface.
  license:
    name: Project License
    url: https://github.com/QuantumNous/new-api/blob/main/LICENSE
servers:
  - url: https://api.powertokens.ai
    description: Baze API service endpoint
security: []
tags:
  - name: Seedream API Compat
    description: Seedream image generation interface
paths:
  /byteplus/api/v3/images/generations:
    post:
      tags:
        - Seedream API Compat
      summary: Image Generation
      description: >-
        Call the Image Generation model to generate images based on text
        prompts. Supports Text-to-Image, Image-to-Image, multi-image fusion,
        batch sequential generation, and other modes.


        **Model Capabilities**


        **Seedream 5.0 pro**

        - Generate single image (does not support sequential_image_generation)

        - Multi-Image Generation: Input multiple reference images (2-10) + text
        prompt to generate a single image.

        - Single Image Generation: Input single reference image + text prompt to
        generate a single image.

        - Text-to-Image: Input text prompt to generate a single image.

        - Interactive Editing: Support specifying editing positions through
        coordinates, bounding boxes, arrows, and other methods for precise image
        editing.

        - Sequential image generation, web search, and streaming output are not
        supported.


        **Seedream 5.0, Seedream 4.5 / 4.0**

        - Generate sequential images (Sequential images: A set of
        content-related images generated based on your input; requires
        sequential_image_generation set to auto)
          - Multi-image to sequential: Generate a set of content-related images based on multiple reference images (2-14) + text prompt (number of input reference images + number of final generated images ≤ 15)
          - Single image to sequential: Generate a set of content-related images based on a single reference image + text prompt (up to 14 images)
          - Text to sequential: Generate a set of content-related images based on text prompt (up to 15 images)
        - Generate single image (set sequential_image_generation to disabled)
          - Multi Image-to-Image: Generate a single image based on multiple reference images (2-14) + text prompt
          - Single Image-to-Image: Generate a single image based on a single reference image + text prompt
          - Text-to-Image: Generate a single image based on text prompt
      operationId: seedreamImageCreate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageCreateRequest'
            examples:
              seedream-5.0-pro-Text-to-Image:
                summary: seedream-5.0-pro-Text-to-Image
                value:
                  model: dola-seedream-5-0-pro-260628
                  prompt: >-
                    Vibrant close-up editorial portrait, model with sharp eyes,
                    wearing a sculptural hat, rich color blocking, sharp eye
                    focus, shallow depth of field, Vogue magazine cover
                    aesthetic, medium format, strong studio lighting.
                  size: 2K
                  output_format: png
                  watermark: false
              seedream-5.0-Text-to-Image:
                summary: seedream-5.0-Text-to-Image
                value:
                  model: seedream-5-0-260128
                  prompt: >-
                    Vibrant close-up editorial portrait, model with sharp eyes,
                    wearing a sculptural hat, rich color blocking, sharp eye
                    focus, shallow depth of field, Vogue magazine cover
                    aesthetic, medium format, strong studio lighting.
                  size: 2K
                  output_format: png
                  watermark: false
              seedream-5.0-Image-to-Image:
                summary: seedream-5.0-Image-to-Image
                value:
                  model: seedream-5-0-260128
                  prompt: >-
                    Keep the model's pose and the flowing shape of the
                    liquid-like clothing unchanged, change the clothing material
                    from silver metal to completely transparent water (or
                    glass), and change the lighting from reflective to
                    refractive.
                  image: https://example.com/reference.png
                  size: 2K
                  output_format: png
                  watermark: false
              seedream-5.0-multi-image-fusion:
                summary: seedream-5.0-multi-image-fusion
                value:
                  model: seedream-5-0-260128
                  prompt: Replace the clothing in image 1 with the clothing in image 2
                  image:
                    - https://example.com/photo1.png
                    - https://example.com/photo2.png
                  size: 2K
                  output_format: png
                  watermark: false
              seedream-5.0-multi-reference-to-sequential:
                summary: seedream-5.0-multi-reference-to-sequential
                value:
                  model: seedream-5-0-260128
                  prompt: >-
                    Generate a set of 4 coherent illustrations centered on the
                    four seasons of the same courtyard corner, showcasing the
                    unique colors, elements, and atmosphere of each season in a
                    unified style.
                  image:
                    - >-
                      https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_1.png
                    - >-
                      https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_2.png
                  sequential_image_generation: auto
                  sequential_image_generation_options:
                    max_images: 3
                  size: 2K
                  output_format: png
                  response_format: url
                  watermark: false
              seedream-5.0-streaming-output:
                summary: seedream-5.0-streaming-output
                value:
                  model: seedream-5-0-260128
                  prompt: >-
                    Reference image 1, generate 4 images, the person in the
                    images wearing sunglasses, riding a motorcycle, wearing a
                    hat, and holding a lollipop respectively.
                  image: >-
                    https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imageToimages_1.png
                  sequential_image_generation: auto
                  sequential_image_generation_options:
                    max_images: 4
                  size: 2K
                  stream: true
                  output_format: png
                  watermark: false
              seedream-5.0-web-search:
                summary: seedream-5.0-web-search
                value:
                  model: seedream-5-0-260128
                  prompt: >-
                    Create a 5-day weather forecast chart for Shanghai, using a
                    modern flat illustration style, clearly showing the daily
                    weather, temperature, and outfit recommendations.
                  size: 2048x2048
                  tools:
                    - type: web_search
                  output_format: png
                  response_format: url
                  watermark: false
      responses:
        '200':
          description: Success, returns the image generation result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageCreateResponse'
              examples:
                Single Image:
                  summary: Single Image
                  value:
                    model: seedream-5-0-260128
                    created: 1757321139
                    data:
                      - url: https://...
                        size: 3104x1312
                    usage:
                      generated_images: 1
                      output_tokens: 0
                      total_tokens: 0
                Single Image — Base64 Format:
                  summary: Single Image — Base64 Format
                  value:
                    model: seedream-5-0-260128
                    created: 1757321139
                    data:
                      - b64_json: iVBORw0KGgoAAAANSUhEUgAA...
                    usage:
                      generated_images: 1
                      output_tokens: 0
                      total_tokens: 0
                Multiple Images:
                  summary: Multiple Images Output
                  value:
                    model: seedream-4-0-250828
                    created: 1757321139
                    data:
                      - url: https://example.com/generated-image-1.jpg
                        size: 2048x2048
                      - url: https://example.com/generated-image-2.jpg
                        size: 2048x2048
                    usage:
                      generated_images: 2
                      output_tokens: 0
                      total_tokens: 0
            text/event-stream:
              schema:
                type: string
                description: >-
                  When `stream` is `true`, the response type is
                  `text/event-stream`, pushing events in real time via the SSE
                  protocol. Each line starts with `event:` or `data:`, and
                  events are separated by blank lines.
              examples:
                seedream-5.0-streaming-output:
                  summary: seedream-5.0-streaming-output
                  value: >
                    event: image_generation.partial_succeeded

                    data:
                    {"type":"image_generation.partial_succeeded","model":"seedream-5-0-260128","created":1757396757,"image_index":0,"url":"https://...","size":"2496x1664"}


                    event: image_generation.partial_succeeded

                    data:
                    {"type":"image_generation.partial_succeeded","model":"seedream-5-0-260128","created":1757396785,"image_index":1,"url":"https://...","size":"2496x1664"}


                    event: image_generation.partial_succeeded

                    data:
                    {"type":"image_generation.partial_succeeded","model":"seedream-5-0-260128","created":1757396825,"image_index":2,"url":"https://...","size":"2496x1664"}


                    event: image_generation.completed

                    data:
                    {"type":"image_generation.completed","model":"seedream-5-0-260128","created":1757396825,"usage":{"generated_images":3,"output_tokens":48672,"total_tokens":48672}}


                    data: [DONE]
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalid_request:
                  summary: Parameter Error
                  value:
                    error:
                      code: bad_request_body
                      message: Invalid request body format or field value
        '401':
          description: >-
            Authentication failed, for example, no token provided or invalid
            token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                unauthorized:
                  summary: Unauthorized
                  value:
                    error:
                      message: Invalid token
                      type: api_error
                      code: access_denied
                      param: ''
        '429':
          description: Rate limit triggered or insufficient account quota.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                quota_exceeded:
                  summary: Insufficient quota or rate limited
                  value:
                    error:
                      message: Insufficient account quota, please try again later
                      type: api_error
                      code: insufficient_user_quota
                      param: ''
        '500':
          description: Internal error occurred while processing the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                internal_error:
                  summary: Internal processing failure
                  value:
                    error:
                      message: >-
                        Internal service processing failure, please try again
                        later
                      type: api_error
                      code: gen_relay_info_failed
                      param: ''
      security:
        - BearerAuth: []
components:
  schemas:
    ImageCreateRequest:
      type: object
      required:
        - model
        - prompt
      properties:
        model:
          type: string
          enum:
            - dola-seedream-5-0-pro-260628
            - seedream-5-0-260128
            - seedream-4-5-251128
            - seedream-4-0-250828
          description: >-
            The Image Generation model name.


            Supported models:

            - `dola-seedream-5-0-pro-260628` (Seedream 5.0 pro, newest
            recommended, supports interactive editing)

            - `seedream-5-0-260128` (Seedream 5.0, supports sequential images,
            web search, streaming output)

            - `seedream-4-5-251128` (Seedream 4.5, supports 4K and strong text
            rendering)

            - `seedream-4-0-250828` (Seedream 4.0, maintenance status, most
            economical 4K option)
          example: seedream-5-0-260128
        prompt:
          type: string
          description: >-
            The prompt for generating images. Supports both Chinese and English.
            It is recommended not to exceed 300 Chinese characters or 600
            English words. If the prompt is too long, the information may be
            diluted, causing the model to ignore details and focus only on key
            points, resulting in missing elements in the image.
          example: >-
            Vibrant close-up editorial portrait, model with sharp eyes, wearing
            a sculptural hat, rich color blocking.
        image:
          oneOf:
            - type: string
              description: The input image information. Supports URL or Base64 encoding.
            - type: array
              description: >-
                Multiple input image information. Supports URL or Base64
                encoding.
              items:
                type: string
              maxItems: 14
          description: >-
            The input image information. Supports URL or Base64 encoding.
            Supports single image or multiple image input.


            - Image URL: Ensure the image URL is accessible.

            - Base64 encoding: Use the format
            `data:image/<image_format>;base64,<base64_encoded>`. Note:
            `<image_format>` must be lowercase, e.g.,
            `data:image/png;base64,<base64_image>`.


            Notes:

            - Requirements for passing a single image:
              - Image formats: jpeg, png, webp, bmp, tiff, gif, heic, heif
              - Aspect ratio (width/height) range: [1/16, 16]
              - Width and height (px) > 14
              - File size: no more than 30MB
              - Total pixels: no more than 6000×6000 = 36000000 px (this is a limit on the pixel product of width and height for a single image, not a limit on individual width or height values)
            - Seedream 5.0 pro supports up to 10 reference images; Seedream
            5.0/4.5/4.0 supports up to 14 reference images.
        size:
          type: string
          description: >-
            Specifies the size information of the generated image. Different
            models support different size methods. Please expand the
            corresponding model descriptions below for details.


            **dola-seedream-5-0-pro-260628 (Seedream 5.0 pro)**

            Supports the following two methods for specifying the generated
            image size. They cannot be used together.


            * Method 1 (Recommended): Specify resolution level and describe
            aspect ratio, image shape, or image purpose in the prompt using
            natural language. The model will determine the final image size.
              * Default: 2K
              * Available values: 1K, 2K

            * Method 2: Specify the pixel width and height of the generated
            image (widthxheight).
              * Total pixel range: [`1280x720` (921600), `2048x2048×1.1025` (4624220)]
              * Aspect ratio range: [1/16, 16]

            > Note: When using Method 2, both the total pixel range and aspect
            ratio range must be satisfied. The total pixel is a limit on the
            product of width and height of a single image, not a limit on
            individual width or height values.

            > * Valid example: `2048x1024`
                Total pixel value 2048x1024=2097152, within the [921600, 4624220] range; aspect ratio 2048/1024=2, within the [1/16, 16] range. Therefore, this example value is valid.
            > * Invalid example: `512x512`
                Total pixel value 512x512=262144, does not meet the minimum requirement of 921600. Therefore, this example value is invalid.

            When using Method 1, the actual pixel width and height mapped by the
            model are as follows (not limited to these standard values, common
            ones listed):


            | Resolution | Aspect Ratio | Pixel Dimensions |

            |---|---|---|

            | 1K | 1:1 | 1024x1024 |

            | | 4:3 | 1152x864 |

            | | 3:4 | 864x1152 |

            | | 16:9 | 1424x800 |

            | | 9:16 | 800x1424 |

            | | 3:2 | 1248x832 |

            | | 2:3 | 832x1248 |

            | | 21:9 | 1568x672 |

            | 2K | 1:1 | 2048x2048 |

            | | 4:3 | 2368x1776 |

            | | 3:4 | 1776x2368 |

            | | 16:9 | 2816x1584 |

            | | 9:16 | 1584x2816 |

            | | 3:2 | 2496x1664 |

            | | 2:3 | 1664x2496 |

            | | 21:9 | 3136x1344 |


            **seedream-5-0-260128 (Seedream 5.0)**

            Supports the following two methods for specifying the generated
            image size. They cannot be used together.


            * Method 1: Specify the resolution of the generated image, and
            describe the aspect ratio, image shape, or image purpose in the
            prompt using natural language. The model will determine the final
            image size.
              * Available values: 2K, 3K, 4K

            * Method 2: Specify the pixel width and height of the generated
            image.
              * Default: `2048x2048`
              * Total pixel range: [`2560x1440` (3686400), `4096x4096` (16777216)]
              * Aspect ratio range: [1/16, 16]

            > Note: When using Method 2, both the total pixel range and aspect
            ratio range must be satisfied. The total pixel is a limit on the
            product of width and height of a single image, not a limit on
            individual width or height values.

            > * Valid example: `3750x1250`
                Total pixel value 3750x1250=4687500, within the [3686400, 16777216] range; aspect ratio 3750/1250=3, within the [1/16, 16] range. Therefore, this example value is valid.
            > * Invalid example: `1500x1500`
                Total pixel value 1500x1500=2250000, does not meet the minimum requirement of 3686400; aspect ratio 1500/1500=1, although within the [1/16, 16] range, it does not satisfy both constraints simultaneously. Therefore, this example value is invalid.

            When using Method 1, the actual pixel width and height mapped by the
            model are as follows:


            | Resolution | Aspect Ratio | Pixel Dimensions |

            |---|---|---|

            | 2K | 1:1 | 2048x2048 |

            | | 4:3 | 2304x1728 |

            | | 3:4 | 1728x2304 |

            | | 16:9 | 2848x1600 |

            | | 9:16 | 1600x2848 |

            | | 3:2 | 2496x1664 |

            | | 2:3 | 1664x2496 |

            | | 21:9 | 3136x1344 |

            | 3K | 1:1 | 3072x3072 |

            | | 4:3 | 3456x2592 |

            | | 3:4 | 2592x3456 |

            | | 16:9 | 4096x2304 |

            | | 9:16 | 2304x4096 |

            | | 3:2 | 3744x2496 |

            | | 2:3 | 2496x3744 |

            | | 21:9 | 4704x2016 |

            | 4K | 1:1 | 4096x4096 |

            | | 4:3 | 4704x3520 |

            | | 3:4 | 3520x4704 |

            | | 16:9 | 5504x3040 |

            | | 9:16 | 3040x5504 |

            | | 3:2 | 4992x3328 |

            | | 2:3 | 3328x4992 |

            | | 21:9 | 6240x2656 |


            **seedream-4-5-251128 (Seedream 4.5)**

            Supports the following two methods for specifying the generated
            image size. They cannot be used together.


            * Method 1: Specify the resolution of the generated image, and
            describe the aspect ratio, image shape, or image purpose in the
            prompt using natural language. The model will determine the final
            image size.
              * Available values: 2K, 4K

            * Method 2: Specify the pixel width and height of the generated
            image.
              * Default: `2048x2048`
              * Total pixel range: [`2560x1440` (3686400), `4096x4096` (16777216)]
              * Aspect ratio range: [1/16, 16]

            > Note: When using Method 2, both the total pixel range and aspect
            ratio range must be satisfied. The total pixel is a limit on the
            product of width and height of a single image, not a limit on
            individual width or height values.

            > * Valid example: `3750x1250`
                Total pixel value 3750x1250=4687500, within the [3686400, 16777216] range; aspect ratio 3750/1250=3, within the [1/16, 16] range. Therefore, this example value is valid.
            > * Invalid example: `1500x1500`
                Total pixel value 1500x1500=2250000, does not meet the minimum requirement of 3686400; aspect ratio 1500/1500=1, although within the [1/16, 16] range, it does not satisfy both constraints simultaneously. Therefore, this example value is invalid.

            When using Method 1, the actual pixel width and height mapped by the
            model are as follows:


            | Resolution | Aspect Ratio | Pixel Dimensions |

            |---|---|---|

            | 2K | 1:1 | 2048x2048 |

            | | 4:3 | 2304x1728 |

            | | 3:4 | 1728x2304 |

            | | 16:9 | 2848x1600 |

            | | 9:16 | 1600x2848 |

            | | 3:2 | 2496x1664 |

            | | 2:3 | 1664x2496 |

            | | 21:9 | 3136x1344 |

            | 4K | 1:1 | 4096x4096 |

            | | 4:3 | 4704x3520 |

            | | 3:4 | 3520x4704 |

            | | 16:9 | 5504x3040 |

            | | 9:16 | 3040x5504 |

            | | 3:2 | 4992x3328 |

            | | 2:3 | 3328x4992 |

            | | 21:9 | 6240x2656 |


            **seedream-4-0-250828 (Seedream 4.0)**

            Supports the following two methods for specifying the generated
            image size. They cannot be used together.


            * Method 1: Specify the resolution of the generated image, and
            describe the aspect ratio, image shape, or image purpose in the
            prompt using natural language. The model will determine the final
            image size.
              * Available values: 1K, 2K, 4K

            * Method 2: Specify the pixel width and height of the generated
            image.
              * Default: `2048x2048`
              * Total pixel range: [`1280x720` (921600), `4096x4096` (16777216)]
              * Aspect ratio range: [1/16, 16]

            > Note: When using Method 2, both the total pixel range and aspect
            ratio range must be satisfied. The total pixel is a limit on the
            product of width and height of a single image, not a limit on
            individual width or height values.

            > * Valid example: `1600x600`
                Total pixel value 1600x600=960000, within the [921600, 16777216] range; aspect ratio 1600/600=8/3, within the [1/16, 16] range. Therefore, this example value is valid.
            > * Invalid example: `800x800`
                Total pixel value 800x800=640000, does not meet the minimum requirement of 921600; aspect ratio 800/800=1, although within the [1/16, 16] range, it does not satisfy both constraints simultaneously. Therefore, this example value is invalid.

            When using Method 1, the actual pixel width and height mapped by the
            model are as follows:


            | Resolution | Aspect Ratio | Pixel Dimensions |

            |---|---|---|

            | 1K | 1:1 | 1024x1024 |

            | | 4:3 | 1152x864 |

            | | 3:4 | 864x1152 |

            | | 16:9 | 1280x720 |

            | | 9:16 | 720x1280 |

            | | 3:2 | 1248x832 |

            | | 2:3 | 832x1248 |

            | | 21:9 | 1512x648 |

            | 2K | 1:1 | 2048x2048 |

            | | 4:3 | 2304x1728 |

            | | 3:4 | 1728x2304 |

            | | 16:9 | 2848x1600 |

            | | 9:16 | 1600x2848 |

            | | 3:2 | 2496x1664 |

            | | 2:3 | 1664x2496 |

            | | 21:9 | 3136x1344 |

            | 4K | 1:1 | 4096x4096 |

            | | 4:3 | 4704x3520 |

            | | 3:4 | 3520x4704 |

            | | 16:9 | 5504x3040 |

            | | 9:16 | 3040x5504 |

            | | 3:2 | 4992x3328 |

            | | 2:3 | 3328x4992 |

            | | 21:9 | 6240x2656 |
          default: 2048x2048
          example: 2K
        sequential_image_generation:
          type: string
          enum:
            - auto
            - disabled
          description: >-
            Controls whether to enable sequential image generation.

            - `auto`: Auto-judgment mode. The model autonomously determines
            whether to return sequential images and how many images to include
            based on the user's prompt.

            - `disabled`: Disable sequential image generation. The model will
            only generate a single image.


            Only Seedream 5.0/4.5/4.0 support this parameter. Seedream 5.0 pro
            does not support sequential image generation.
          default: disabled
        sequential_image_generation_options:
          type: object
          description: >-
            Configuration for sequential image generation. Only takes effect
            when `sequential_image_generation` is set to `auto`.


            Only Seedream 5.0/4.5/4.0 support this parameter.
          properties:
            max_images:
              type: integer
              description: >-
                Specifies the maximum number of images that can be generated in
                this request.

                - Value range: [1, 15]


                Note: The actual number of images that can be generated is
                affected by both `max_images` and the number of input reference
                images. Number of input reference images + number of final
                generated images ≤ 15.
              minimum: 1
              maximum: 15
              default: 15
        tools:
          type: array
          description: >-
            Configures the tools to be called by the model.


            Only `seedream-5-0-260128` (Seedream 5.0) supports this parameter.
            Seedream 5.0 pro does not support web search.
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                  - web_search
                description: >-
                  Specifies the tool type to use.

                  - `web_search`: Web search functionality.


                  Notes:

                  - When web search is enabled, the model autonomously
                  determines whether to search the internet (e.g., products,
                  weather) based on the user's prompt, improving the timeliness
                  of generated images, though it may increase latency.

                  - The actual number of searches can be queried via the
                  `usage.tool_usage.web_search` field. If it is 0, no search was
                  performed.
            required:
              - type
          example:
            - type: web_search
        stream:
          type: boolean
          description: >-
            Controls whether to enable streaming output mode.

            - `false`: Non-streaming output mode. Wait for all images to be
            generated before returning all information at once.

            - `true`: Streaming output mode. Returns the result of each image in
            real time. This mode is effective for both single image generation
            and sequential image generation scenarios.


            Only Seedream 5.0/4.5/4.0 support streaming response. Seedream 5.0
            pro does not support streaming output. See the "Streaming Response"
            documentation for details.
          default: false
        guidance_scale:
          type: number
          description: >-
            Controls the consistency between the model output and the prompt,
            i.e., the freedom of the generated image. Also known as text weight.
            The larger the value, the lower the model freedom and the stronger
            the correlation with the user's input prompt.

            - Value range: [1, 10]


            **Seedream 5.0/4.5/4.0 do not support this parameter**.
          minimum: 1
          maximum: 10
          example: 5
        output_format:
          type: string
          enum:
            - jpeg
            - png
          description: >-
            Specifies the file format of the generated image.

            - Supported values: png, jpeg

            - Only `seedream-5-0-260128` (Seedream 5.0) supports this parameter.

            - For Seedream 5.0 pro/4.5/4.0 models, the generated image format
            defaults to jpeg and cannot be customized.
          default: jpeg
        response_format:
          type: string
          enum:
            - url
            - b64_json
          description: >-
            Specifies the return format of the generated image. Supports the
            following two return methods:

            - `url`: Returns the image download link. The link is valid for 24
            hours after image generation. Please download the image in time.

            - `b64_json`: Returns image data as a Base64-encoded string in JSON
            format.
          default: url
        watermark:
          type: boolean
          description: >-
            Whether to add a watermark to the generated image.

            - `false`: Do not add a watermark.

            - `true`: Add an "AI Generated" watermark identifier at the bottom
            right corner of the image.
          default: true
        optimize_prompt_options:
          type: object
          description: |-
            Configuration for prompt optimization.

            Only Seedream 5.0/4.5/4.0 support this parameter.
          properties:
            mode:
              type: string
              enum:
                - standard
                - fast
              description: >-
                Sets the mode for prompt optimization.

                - `standard`: Standard mode, higher quality generated content
                but longer processing time.

                - `fast`: Fast mode, shorter processing time but average
                quality. Currently not supported by Seedream 5.0/4.5.
              default: standard
    ImageCreateResponse:
      type: object
      properties:
        model:
          type: string
          description: The model ID used for this request (model name-version).
        created:
          type: integer
          format: int64
          description: The Unix timestamp (seconds) of the creation time for this request.
        data:
          type: array
          description: >-
            Output image information.


            Note: In the sequential image generation scenario with Seedream
            5.0/4.5/4.0 models, when an image fails during sequential image
            generation:

            - If the failure reason is content moderation rejection: It will
            continue to request the next image generation task, meaning it does
            not affect the generation flow of other images within the same
            request.

            - If the failure reason is an internal service error (500): It will
            not continue to request the next image generation task.
          items:
            $ref: '#/components/schemas/ImageData'
        tools:
          type: array
          description: Configured model tools for this request.
          items:
            type: object
            properties:
              type:
                type: string
                description: |-
                  The configured tool type.
                  - `web_search`: Web search tool.
        usage:
          type: object
          description: Usage information for this request.
          properties:
            generated_images:
              type: integer
              description: >-
                The number of successfully generated images. Images that failed
                to generate are not included. Billing is based on the number of
                successfully generated images.
            output_tokens:
              type: integer
              description: >-
                Number of tokens spent on the generated image. Calculation
                logic: sum(image width × image height) / 256, then rounded.
            total_tokens:
              type: integer
              description: >-
                Total number of tokens consumed for this request. Input tokens
                are not currently counted, so this matches the output_tokens
                value.
            tool_usage:
              type: object
              description: Usage information for tools used.
              properties:
                web_search:
                  type: integer
                  description: >-
                    The number of times the web search tool was called. Only
                    returned when web search is enabled.
        error:
          type: object
          description: Error information for this request, if an error occurred.
          properties:
            code:
              type: string
              description: See Error code.
            message:
              type: string
              description: Error message.
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Error code.
            message:
              type: string
              description: Error message.
            type:
              type: string
              description: Error type.
            param:
              type: string
              description: The name of the parameter that triggered the error.
    ImageData:
      type: object
      description: Information about a successfully or failed image generation.
      properties:
        url:
          type: string
          description: >-
            The URL of the generated image. Returned when `response_format` is
            set to `url`. The link will expire 24 hours after generation. Please
            save the image in time.


            It is recommended to configure the data subscription feature
            provided by Volcano Engine TOS to automatically transfer your model
            inference outputs to your own TOS bucket for long-term backup or
            further processing.
        b64_json:
          type: string
          description: >-
            The Base64-encoded image data. Returned when `response_format` is
            set to `b64_json`.
        size:
          type: string
          description: >-
            Only supported by Seedream 5.0/4.5/4.0. The pixel dimensions of the
            image, in the format <width>x<height>, e.g., 2048x2048.
        error:
          type: object
          description: Error information for a failed image generation.
          properties:
            code:
              type: string
              description: Error code for a failed image generation. See Error code.
            message:
              type: string
              description: Error message for a failed image generation.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Pass in the request header as `Authorization: Bearer <token>`.'

````