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

[ByteDance](https://seed.bytedance.com) の Seedream モデルを使用して画像を生成します。単一画像モードと複数画像モードに対応しています。

**モデルの特徴:**

* **マルチバージョン対応** - 5.0-lite（デフォルト）、4.5、4.0 をサポート
* **柔軟な出力モード** - 単一画像（`max_images=1`）または複数画像（`max_images=2-15`）
* **テキストから画像 & 画像から画像** - テキスト説明または参照画像（最大14枚）から生成
* **HD出力** - 5.0-lite は 2K/3K、4.5/4.0 は 2K/4K に対応、または正確な解像度を指定可能


## OpenAPI

````yaml /ja/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: 本番サーバー
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: タスクパラメータ
        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）
            2つの形式をサポート：
            - サイズ区分：2K、3K（5.0-lite）または2K、4K（4.5/4.0）、モデルがプロンプトに基づいてアスペクト比を自動判断
            - 正確な解像度：幅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: タスクID
          example: 01234567-89ab-cdef-0123-456789abcdef
          type: string
      required:
        - task_id
      type: object
    apierror.ErrorResponse:
      properties:
        error_code:
          description: '機械可読なエラーコード（例: TASK.INVALID_PARAMS）'
          type: string
        message:
          description: ユーザーフレンドリーなエラーメッセージ
          type: string
      type: object
  securitySchemes:
    AccessToken:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: API Tokenを使用して認証を行ってください

````