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

> ByteDance's text-to-image model for product visuals, posters, stickers, and design assets. It follows detailed composition prompts and generates native transparent or translucent backgrounds for elements that can be reused in larger designs.



## OpenAPI

````yaml /media-model-api/bytedance/bytedance-t2i.json post /bytedance/seedream-5.5
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.5:
    post:
      summary: Seedream 5.5
      description: >-
        ByteDance's text-to-image model for product visuals, posters, stickers,
        and design assets. It follows detailed composition prompts and generates
        native transparent or translucent backgrounds for elements that can be
        reused in larger designs.
      operationId: seedream55T2iAsync
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Seedream55T2iRequest'
            examples:
              basic:
                summary: Generate an image with default settings
                value:
                  prompt: A cinematic landscape in a 16:9 composition
              transparent:
                summary: Native RGBA PNG
                value:
                  prompt: A small ceramic cat sticker with a transparent background
                  size: 1K
                  background: transparent
                  output_format: png
                  optimize_prompt_mode: standard
                  safety_identifier: hashed-user-1
      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-seedream55-example
                  model_id: bytedance/seedream-5.5
                  get_result:
                    method: GET
                    url: >-
                      https://api.modellix.ai/api/v1/tasks/task-seedream55-example
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    Seedream55T2iRequest:
      type: object
      required:
        - prompt
      additionalProperties: false
      properties:
        prompt:
          type: string
          minLength: 1
          maxLength: 10000
          description: >-
            Describe the desired image. Required, with up to 10000 characters.
            Keep the instructions focused and describe the aspect ratio in the
            prompt.
          example: A detailed landscape in a 16:9 composition
          pattern: \S
        size:
          type: string
          enum:
            - 1K
            - 1.5K
            - 2K
          default: 2K
          description: >-
            Output resolution preset. Describe the aspect ratio in the prompt.
            Custom dimensions, auto, and 4K are rejected.
        output_format:
          type: string
          enum:
            - png
            - jpeg
          default: png
          description: Output file format. Transparent backgrounds require PNG.
        background:
          type: string
          enum:
            - auto
            - transparent
            - opaque
          default: auto
          description: >-
            Generation background mode. transparent produces RGBA and requires
            PNG.
        optimize_prompt_mode:
          type: string
          enum:
            - standard
          default: standard
          description: Prompt optimization mode. Seedream 5.5 supports standard only.
        safety_identifier:
          type: string
          minLength: 1
          maxLength: 64
          pattern: ^[\x20-\x7E]+$
          description: >-
            Optional stable English identifier for the end user. Prefer a hash
            instead of personal information. The upstream value is preserved in
            the completed result.
      allOf:
        - not:
            required:
              - background
              - output_format
            properties:
              background:
                const: transparent
              output_format:
                const: jpeg
    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`.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.