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

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

**Model Capabilities**
- 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.
- Sequential image generation, web search, and streaming output are not supported.



## OpenAPI

````yaml api-reference/en/zmodelImage/byteplus/seedream-5-0-pro-image-to-image.json POST /v1/images/generations
openapi: 3.0.1
info:
  title: Seedream 5.0 Pro Image-to-Image
  version: 1.0.0
  description: >-
    Seedream 5.0 pro Image-to-Image and multi-image reference 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 Image-to-Image
      description: >-
        Supported models include `dola-seedream-5-0-pro-260628`. This document
        covers Image-to-Image and Multi-Image Reference Generation scenarios.
        Public fields include `model`, `prompt`, `image`, `size`,
        `response_format`, and `watermark`.


        **Model Capabilities**

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

        - Sequential image generation, web search, and streaming output are not
        supported.
      operationId: byteplusImageToImage50Pro
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageToImageRequest'
            examples:
              image_to_image:
                summary: Basic Image-to-Image
                value:
                  model: dola-seedream-5-0-pro-260628
                  prompt: Convert the image to Studio Ghibli animation style
                  image: https://example.com/input.jpg
                  size: 2K
              multi_image_reference:
                summary: Multi-Image Reference Generation
                value:
                  model: dola-seedream-5-0-pro-260628
                  prompt: >-
                    Combine the styles of these images to generate a new
                    landscape
                  image:
                    - https://example.com/ref1.jpg
                    - https://example.com/ref2.jpg
                  size: 2K
      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:
    ImageToImageRequest:
      type: object
      required:
        - model
        - prompt
        - image
      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.
        image:
          oneOf:
            - type: string
              description: Input image information, supports URL or Base64 encoding.
            - type: array
              description: >-
                Input multiple image information, supports URL or Base64
                encoding.
              items:
                type: string
              maxItems: 10
          description: >-
            Input image information, supports URL or Base64 encoding. Supports
            single or multiple image inputs.


            - Image URL: Ensure the image URL is accessible.

            - Base64 encoding: Follow the format
            `data:image/<image_format>;base64,<Base64_encoded>`. Note that
            `<image_format>` should be lowercase, e.g.,
            `data:image/png;base64,<base64_image>`.


            Notes:

            - Single image requirements:
              - Format: jpeg, png, webp, bmp, tiff, gif, heic, heif
              - Aspect ratio (width/height) range: [1/16, 16]
              - Width/height (px) > 14
              - Size: no more than 30MB
              - Total pixels: no more than 6000×6000 = 36000000 px (limit on the product of width and height, not individual values)
            - Seedream 5.0 pro supports up to 10 reference images.
        size:
          type: string
          description: >
            Specifies the size of the generated image, supports specifying
            resolution level (e.g., 2K) or width and height pixel values (e.g.,
            2048x2048), which cannot be mixed.


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

            Supports the following two methods, which cannot be mixed:


            * Method 1 (Recommended): Specify resolution level and describe
            aspect ratio, shape, or purpose in the prompt. The model determines
            the final image size.
              * Default: 2K
              * Options: 1K, 2K

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

            > Note: When using Method 2, both total pixel range and aspect ratio
            range must be satisfied. Total pixels refers to the product of width
            and height, not individual values.

            > * Valid example: `2048x1024`
                Total pixels 2048x1024=2097152, within [921600, 4624220]; aspect ratio 2048/1024=2, within [1/16, 16], so valid.
            > * Invalid example: `512x512`
                Total pixels 512x512=262144, below 921600 minimum, so invalid.

            Resolution to pixel reference values when using Method 1 (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 |
          default: 2K
          example: 2K
          x-enum:
            - 1K
            - 2K
        response_format:
          type: string
          enum:
            - url
            - b64_json
          description: >-
            Specifies the return format of the generated image. Supported
            options:

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

            - `b64_json`: Returns image data as Base64 encoded JSON.
          default: url
        watermark:
          type: boolean
          description: |-
            Whether to add watermark to generated images.
            - `false`: No watermark.
            - `true`: Add "AI Generated" watermark at bottom right corner.
          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.'

````