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

> ## Agent Instructions
> Send API requests to https://api.ttapi.io with the TT-API-KEY header. Midjourney account hosting uses https://hold.ttapi.io. Claude Code uses https://cc.ttapi.io.
> Most generation endpoints are asynchronous. The submit response returns a job id. Poll that product's fetch endpoint, or pass a webhook on the submit request. A fetch call does not start a new generation.
> 1 USD = 100 quota. Check the pricing page for that product before estimating cost.
> This file lists the English docs. Follow every /_llms/ link recursively for the API reference, Chinese, and Russian. Open a page's .md URL for the endpoint schema.

# Multi-Image Fusion

> Multi-Image Fusion - Submit async image generation task, return id

This is the **Seedream Image Generation API** multi-image fusion endpoint. Fuse and generate new image based on multiple reference images (2-10). Submit async task and return `id`, use query endpoint to get results.


## OpenAPI

````yaml openapi/en/seedream-multi-image.json POST /sd/api/v3/images/generations/tasks
openapi: 3.1.0
info:
  title: Seedream - Multi-Image Fusion
  version: 1.0.0
  description: >-
    Seedream Multi-Image Fusion API - Fuse and generate new image based on
    multiple reference images.
servers:
  - url: https://api.ttapi.io
security: []
paths:
  /sd/api/v3/images/generations/tasks:
    post:
      description: Multi-Image Fusion - Submit async image generation task, return id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MultiImageRequest'
            example:
              model: doubao-seedream-5-0-pro-260628
              prompt: Fuse characters from two images into the same scene
              image:
                - https://example.com/ref1.jpg
                - https://example.com/ref2.jpg
              size: 2K
              watermark: false
      responses:
        '200':
          description: Task submitted successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: PENDING_QUEUE
                    description: Task status
                  message:
                    type: string
                    example: success
                  id:
                    type: string
                    description: Task ID
                    example: 30d9b07d-7349-4cbc-8e11-9ba302c6d165
                required:
                  - status
                  - message
                  - id
      security:
        - CustomApiKey: []
components:
  schemas:
    MultiImageRequest:
      type: object
      description: Multi-Image Fusion request parameters
      properties:
        model:
          type: string
          description: Model name.
          enum:
            - doubao-seedream-5-0-pro-260628
            - doubao-seedream-5-0-flash-260915
          example: doubao-seedream-5-0-pro-260628
        prompt:
          type: string
          description: Text prompt describing the fusion intent.
        image:
          type: array
          description: Array of reference image URLs, supports 2-10 images.
          items:
            type: string
          minItems: 2
          maxItems: 10
        size:
          type: string
          description: >-
            Image size. 5.0 pro/flash options: 1K, 1.5K, 2K (default 2K), or
            specify pixel values.
          default: 2K
          enum:
            - 1K
            - 1.5K
            - 2K
        output_format:
          type: string
          description: Output image format.
          default: jpeg
          enum:
            - png
            - jpeg
        response_format:
          type: string
          description: Return format.
          default: url
          enum:
            - url
            - b64_json
        watermark:
          type: boolean
          description: >-
            Whether to add watermark. true=Display "AI Generated" in
            bottom-right, false=Do not add.
          default: true
          enum:
            - true
            - false
          example: false
        optimize_prompt_options:
          type: object
          description: Prompt optimization config
          properties:
            mode:
              type: string
              enum:
                - standard
                - fast
              default: standard
              description: >-
                Optimization mode. standard=standard mode (higher quality,
                longer time), fast=fast mode (shorter time, slightly lower
                quality, 5.0 flash not supported)
        execution_expires_after:
          type: integer
          default: 172800
          description: >-
            Task timeout threshold (seconds). Range [3600, 259200] (1-72 hours),
            default 172800 (48 hours)
        priority:
          type: integer
          default: 0
          description: >-
            Execution priority. Range [0, 9], higher value = higher priority,
            default 0 (FIFO)
        safety_identifier:
          type: string
          description: >-
            End user unique identifier, max 64 characters. Recommend passing a
            hashed string
      required:
        - model
        - prompt
        - image
  securitySchemes:
    CustomApiKey:
      type: apiKey
      in: header
      name: TT-API-KEY
      description: >-
        Get your API key from the <a href='https://dashboard.ttapi.io'
        target='_blank'>TTAPI Dashboard</a>.

````

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