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

# Seedream 图片生成

> 使用火山引擎 Seedream 模型生成图片，支持单图和组图模式，可选 4.0、4.5 或 5.0-lite 版本（同步）
- max_images = 1：生成单张图片
- max_images > 1：生成组图，最多 N 张
- max_images 不设置：自动组图模式，最多 15 张

使用[字节跳动](https://seed.bytedance.com)的 Seedream 模型生成图片，支持单图和组图模式。

**模型特点：**

* **多版本支持** - 支持 5.0-lite（默认）、4.5、4.0 三个版本
* **灵活输出模式** - 单图（`max_images=1`）或组图（`max_images=2-15`）
* **文生图 & 图生图** - 支持从文本描述或参考图片（最多 14 张）生成
* **高清输出** - 5.0-lite 支持 2K/3K，4.5/4.0 支持 2K/4K，也可指定精确分辨率


## OpenAPI

````yaml /cn/openapi.yaml POST /generate/vol/seedream
openapi: 3.0.0
info:
  contact:
    email: support@sinancode.com
    name: API Support
    url: https://sinancode.com/support
  description: AI 模型任务调度平台 API
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  termsOfService: https://sinancode.com/terms-of-service
  title: TikTomato API
  version: '1.0'
servers:
  - url: https://api.sinancode.com/v1
    description: Production server
security: []
paths:
  /generate/vol/seedream:
    post:
      tags:
        - public
      summary: Seedream 图片生成
      description: |-
        使用火山引擎 Seedream 模型生成图片，支持单图和组图模式，可选 4.0、4.5 或 5.0-lite 版本（同步）
        - max_images = 1：生成单张图片
        - max_images > 1：生成组图，最多 N 张
        - max_images 不设置：自动组图模式，最多 15 张
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/vol.CreateSeedreamTaskRequest'
        description: Task parameters
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dto.CreateTaskResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apierror.ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apierror.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apierror.ErrorResponse'
      security:
        - AccessToken: []
components:
  schemas:
    vol.CreateSeedreamTaskRequest:
      properties:
        images:
          description: |-
            输入图片（可选，支持多张参考图，最多14张）
            示例: ["https://example.com/1.jpg", "https://example.com/2.jpg"]
          example:
            - https://media.sinancode.com/uploads/1765851887405-rfpmtj1u.png
          items:
            type: string
          type: array
        max_images:
          default: 1
          description: |-
            最大图片数（可选，默认1）
            - 设置为 1：生成单张图片（禁用组图功能）
            - 设置为 2-15：生成组图，最多 N 张（输入图数量+生成数量 ≤ 15）
          example: 4
          maximum: 15
          minimum: 1
          type: integer
        prompt:
          description: 提示词（必填，建议不超过300个汉字或600个英文单词）
          example: 把这张照片变成黏土风格。放在一张拍立得照片中...
          maxLength: 2000
          minLength: 1
          type: string
        size:
          default: 2K
          description: |-
            图片尺寸（可选，默认 2K）
            支持两种格式：
            - 档位：2K, 3K（5.0-lite）或 2K, 4K（4.5/4.0），由模型根据 prompt 自动判断宽高比
            - 精确分辨率：宽x高，如 "2048x2048"、"2560x1440"
          example: 2K
          type: string
        version:
          default: 5.0-lite
          description: |-
            模型版本（可选，默认 5.0-lite）
            可选值：4.0, 4.5, 5.0-lite
          enum:
            - '4.0'
            - '4.5'
            - 5.0-lite
          example: 5.0-lite
          type: string
      required:
        - prompt
      type: object
    dto.CreateTaskResponse:
      properties:
        task_id:
          description: Task ID
          example: 01234567-89ab-cdef-0123-456789abcdef
          type: string
      required:
        - task_id
      type: object
    apierror.ErrorResponse:
      properties:
        error_code:
          description: Machine-readable error code (e.g. TASK.INVALID_PARAMS)
          type: string
        message:
          description: User-friendly error message
          type: string
      type: object
  securitySchemes:
    AccessToken:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 请使用您的 API Token 进行认证

````