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

# Seedream 5.0 Pro

> [Core Function] Seedream 5.0 Pro is ByteDance's flagship professional-grade Text-to-Image (T2I) generation model. [Strengths] It delivers top-tier image quality with enhanced precision control over positions and elements, superior prompt adherence, and improved generation consistency for professional scenarios. [Best For] Highly recommended for: professional design assets, high-fidelity photorealistic imagery, precisely controlled compositions, and brand or commercial visuals where quality matters most. [Limitations] Do NOT use this model for batch image generation or streaming output; it generates exactly one image per request and supports up to 2K resolution (no 3K/4K). [Routing] Choose this Pro model when the user emphasizes ultimate quality or precision. Choose Seedream 5.0 Lite when real-time web knowledge, batch generation, or 3K resolution is needed. To edit an existing image use Seedream 5.0 Pro Edit; to blend multiple reference images use Seedream 5.0 Pro Multi-Reference.



## OpenAPI

````yaml /model-api/bytedance/bytedance-t2i.json post /bytedance/seedream-5.0-pro
openapi: 3.1.0
info:
  description: The text-to-image models API from ByteDance.
  version: 1.0.0
  contact:
    name: Modellix Support
    email: support@modellix.ai
  title: ByteDance Text-to-Image Models API
servers:
  - url: https://api.modellix.ai/api/v1
    description: The text-to-image models API from ByteDance.
security:
  - bearerAuth: []
paths:
  /bytedance/seedream-5.0-pro:
    post:
      summary: Seedream 5.0 Pro
      description: >-
        [Core Function] Seedream 5.0 Pro is ByteDance's flagship
        professional-grade Text-to-Image (T2I) generation model. [Strengths] It
        delivers top-tier image quality with enhanced precision control over
        positions and elements, superior prompt adherence, and improved
        generation consistency for professional scenarios. [Best For] Highly
        recommended for: professional design assets, high-fidelity
        photorealistic imagery, precisely controlled compositions, and brand or
        commercial visuals where quality matters most. [Limitations] Do NOT use
        this model for batch image generation or streaming output; it generates
        exactly one image per request and supports up to 2K resolution (no
        3K/4K). [Routing] Choose this Pro model when the user emphasizes
        ultimate quality or precision. Choose Seedream 5.0 Lite when real-time
        web knowledge, batch generation, or 3K resolution is needed. To edit an
        existing image use Seedream 5.0 Pro Edit; to blend multiple reference
        images use Seedream 5.0 Pro Multi-Reference.
      operationId: seedream50ProT2iAsync
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Seedream50ProT2iRequest'
            examples:
              basic:
                summary: Basic generation
                value:
                  prompt: A cinematic sunset over a futuristic city skyline
              full_params:
                summary: Full parameters with PNG output
                value:
                  prompt: >-
                    A futuristic city at sunset, ultra detailed, cinematic
                    lighting, volumetric clouds
                  size: 2048x2048
                  optimize_prompt_mode: fast
                  output_format: png
      responses:
        '200':
          description: Task submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsyncTaskResponse'
              example:
                code: 0
                message: success
                data:
                  status: pending
                  task_id: task-seedream50pro001
                  model_id: bytedance/seedream-5.0-pro
                  get_result:
                    method: GET
                    url: https://api.modellix.ai/api/v1/tasks/task-seedream50pro001
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    Seedream50ProT2iRequest:
      type: object
      required:
        - prompt
      properties:
        prompt:
          type: string
          description: >-
            Image description text, supports Chinese and English. Maximum 10000
            characters. We recommend keeping the prompt under 600 words.
            Excessively long prompts may scatter information, causing the model
            to overlook details and focus only on major elements, which can
            result in missing details in the generated image.
          minLength: 1
          maxLength: 10000
          example: A futuristic city at sunset, ultra detailed
        size:
          type: string
          description: >-
            Image size in format 'widthxheight'. Total pixels must be within
            [1280x720(921,600), 4,624,220] and aspect ratio within [1/16, 16],
            corresponding to the official 1K/2K resolution levels (3K/4K not
            supported). Recommended 2K sizes: 2048x2048 (1:1), 2816x1584 (16:9),
            2368x1776 (4:3).
          default: 1024x1024
          example: 2048x2048
        optimize_prompt_mode:
          type: string
          enum:
            - standard
            - fast
          description: >-
            Prompt optimization mode. 'standard': higher quality with longer
            generation time. 'fast': faster generation with slightly lower
            quality.
          default: standard
          example: standard
        output_format:
          type: string
          enum:
            - jpeg
            - png
          description: 'Output image format. Supported values: ''jpeg'' and ''png''.'
          default: jpeg
          example: png
    AsyncTaskResponse:
      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:
          type: object
          required:
            - status
            - task_id
            - model_id
          properties:
            status:
              type: string
              enum:
                - pending
                - processing
              description: Task status
              example: pending
            task_id:
              type: string
              description: Unique task identifier
              example: task-abc123
            model_id:
              type: string
              description: Model ID
              example: model-123
            get_result:
              type: object
              description: API information to query the task result
              properties:
                method:
                  type: string
                  description: HTTP method
                  example: GET
                url:
                  type: string
                  description: Full URL to query the task result
                  example: https://api.modellix.ai/api/v1/tasks/task-abc123
          description: Detailed data about the submitted asynchronous task.
    ErrorResponse:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: integer
          description: Error code (equals HTTP status code)
          example: 400
        message:
          type: string
          description: 'Error message in format ''Category: detail'''
          example: 'Invalid parameters: parameter ''prompt'' is required'
  responses:
    BadRequest:
      description: Invalid request parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            code: 400
            message: 'Invalid parameters: parameter ''prompt'' is required'
    Unauthorized:
      description: Unauthorized - Invalid or missing API Key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            code: 401
            message: 'Authentication failed: invalid API key'
    TooManyRequests:
      description: Too many requests - Rate limit exceeded
      headers:
        X-RateLimit-Limit:
          description: Maximum requests per minute
          schema:
            type: integer
            example: 100
        X-RateLimit-Remaining:
          description: Remaining quota in current window
          schema:
            type: integer
            example: 0
        X-RateLimit-Reset:
          description: Rate limit window reset time (Unix timestamp)
          schema:
            type: integer
            example: 1704067260
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            code: 429
            message: >-
              Rate limit exceeded: 100 requests per minute, retry after 60
              seconds
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            code: 500
            message: Internal server error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.'

````