> ## 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.

# Seedream 5.0 Pro Text-to-Image

> Supported models include `dola-seedream-5-0-pro-260628`. This document covers Text-to-Image scenarios. Public fields include `model`, `prompt`, `size`, `response_format`, and `watermark`.

**Model Capabilities**
- Generate single image (does not support sequential_image_generation)
- Text-to-Image: Input text prompt to generate a single image.
- Sequential image generation, web search, and streaming output are not supported.



## OpenAPI

````yaml api-reference/en/zmodelImage/byteplus/seedream-5-0-pro-text-to-image.json POST /v1/images/generations
openapi: 3.0.1
info:
  title: Seedream 5.0 Pro Text-to-Image
  version: 1.0.0
  description: >-
    Seedream 5.0 pro Text-to-Image capability documentation. The public unified
    endpoint is `/v1/images/generations`.
  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 Image
    description: Seedream series image generation capabilities
paths:
  /v1/images/generations:
    post:
      tags:
        - Seedream Image
      summary: Seedream 5.0 Pro Text-to-Image
      description: >-
        Supported models include `dola-seedream-5-0-pro-260628`. This document
        covers Text-to-Image scenarios. Public fields include `model`, `prompt`,
        `size`, `response_format`, and `watermark`.


        **Model Capabilities**

        - Generate single image (does not support sequential_image_generation)

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

        - Sequential image generation, web search, and streaming output are not
        supported.
      operationId: byteplusTextToImage50Pro
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TextToImageRequest'
            examples:
              text_to_image:
                summary: Basic Text-to-Image
                value:
                  model: dola-seedream-5-0-pro-260628
                  prompt: >-
                    A cute corgi running on the grass, sunny day, realistic
                    style
                  size: 2K
                  response_format: url
      responses:
        '200':
          description: Success, returns the image generation result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageGenerationResponse'
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                invalid_request:
                  summary: Invalid Parameters
                  value:
                    error:
                      message: Request body format error or invalid field values
                      type: invalid_request_error
                      code: bad_request_body
                      param: ''
        '401':
          description: Authentication failed, e.g., token not provided or invalid.
          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 exceeded or insufficient account quota.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                quota_exceeded:
                  summary: Quota Exceeded or Rate Limited
                  value:
                    error:
                      message: Insufficient account quota, please try again later
                      type: api_error
                      code: insufficient_user_quota
                      param: ''
        '500':
          description: Internal server error occurred during request processing.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                internal_error:
                  summary: Internal Processing Failed
                  value:
                    error:
                      message: >-
                        Internal service processing failed, please try again
                        later
                      type: api_error
                      code: gen_relay_info_failed
                      param: ''
      security:
        - BearerAuth: []
components:
  schemas:
    TextToImageRequest:
      type: object
      required:
        - model
        - prompt
      properties:
        model:
          type: string
          enum:
            - dola-seedream-5-0-pro-260628
          description: >-
            Image generation model name. Supported models include
            `dola-seedream-5-0-pro-260628` (Seedream 5.0 pro, supports
            interactive editing, does not support sequential image generation).
        prompt:
          type: string
          description: >-
            Prompt for image generation, supports Chinese and English. It is
            recommended not to exceed 300 Chinese characters or 600 English
            words. Too many words may disperse information, causing the model to
            ignore details and focus only on key points, resulting in missing
            elements in the image.
          example: >-
            Dynamic close-up editorial portrait with sharp gaze, sculptural hat,
            rich color blocking.
        size:
          type: string
          description: >-
            Specifies the dimensions of the generated image. Supports the
            following two methods, which cannot be used at the same time:


            * **Method 1 (Recommended)**: Specify the resolution level of the
            generated image, and describe its aspect ratio, shape, or purpose in
            the prompt using natural language. The model determines the final
            image size.
              * Default: `2K`
              * Available values: `1K`, `1.5K`, `2K`
              * *Pricing note*: `1.5K` has the same price as `1K` while providing better image generation quality.

            * **Method 2**: Specify the width and height of the generated image
            in pixels (`widthxheight`):
              * Total pixels range: [`1280x720` (921,600), `2048x2048x1.1025` (4,624,220)]
              * 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 limit applies to the product of width and height, rather than to either dimension individually.
                * Valid example: `2048x1024` (Total pixel count: 2048x1024=2,097,152; aspect ratio: 2048/1024=2)
                * Invalid example: `512x512` (Total pixel count: 512x512=262,144, below 921,600 minimum)

            **Resolution to Pixel Reference Values (Method 1)**:


            | Resolution | Aspect Ratio | Width and Height Pixel Values |

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

            | 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 |

            | 1.5K | 1:1 | 1536x1536 |

            | | 4:3 | 1792x1344 |

            | | 3:4 | 1344x1792 |

            | | 16:9 | 2048x1152 |

            | | 9:16 | 1152x2048 |

            | | 3:2 | 1872x1248 |

            | | 2:3 | 1248x1872 |

            | | 21:9 | 2352x1008 |

            | 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 |
          default: 2K
          example: 2K
          x-enum:
            - 1K
            - 1.5K
            - 2K
        response_format:
          type: string
          enum:
            - url
            - b64_json
          description: >-
            Specifies how generated images are returned. Supported options:

            - `url`: Returns a download URL for the image; valid for 24 hours
            after generation.

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

            - `false`: Does not add a watermark.

            - `true`: Adds an "AI-generated" watermark in the lower-right corner
            of the image.
          default: true
    ImageGenerationResponse:
      type: object
      properties:
        model:
          type: string
          description: Model ID (model name-version) used for this request.
        created:
          type: integer
          format: int64
          description: Unix timestamp (seconds) of creation.
        data:
          type: array
          items:
            $ref: '#/components/schemas/ImageData'
          description: List of generated images.
        usage:
          type: object
          description: Usage information for this request.
          properties:
            generated_images:
              type: integer
              description: Number of successfully generated images, excluding failed ones.
            output_tokens:
              type: integer
              description: Token count for generated images.
            total_tokens:
              type: integer
              description: Total token count for this request.
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            code:
              type: string
    ImageData:
      type: object
      properties:
        url:
          type: string
          description: Image download URL. Valid for 24 hours, please save promptly.
        b64_json:
          type: string
          description: Base64 encoded image data.
        size:
          type: string
          description: Image dimensions (widthxheight).
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Pass `Authorization: Bearer <token>` in the request header.'

````