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

# Seedance 2.0 Fast

> Seedance 2.0 Fast 视频生成模型（有声/无声），Seedance 2.0 的轻量快速版本，能力与参数完全一致



## OpenAPI

````yaml /zh/openapi/videos/seedance-2-0-fast.yaml POST /v1/videos/generate
openapi: 3.1.0
info:
  title: Seedance 2.0 Fast
  version: '1.0'
  description: Seedance 2.0 Fast 视频生成模型（有声/无声），Seedance 2.0 的轻量快速版本，参数与能力与 Seedance 2.0 一致。
servers:
  - url: https://openapi.imini.ai/imini/router
security:
  - ApiKeyAuth: []
paths:
  /v1/videos/generate:
    post:
      summary: Seedance 2.0 Fast
      description: >
        提交异步的视频生成任务，后续需通过查询接口轮询结果。


        > 模型 ID：`doubao/seedance-2.0-fast` · 底层：Seedance 2.0 Fast


        能力、参数、输入模式与 `doubao/seedance-2.0` 完全一致，生成速度更快、价格更低，适合对推理时效性要求较高的场景。


        **支持的输入模式**：

        - **文生视频**：仅传 `prompt`

        - **图生视频-首帧**：1 张 `first_frame`

        - **图生视频-首尾帧**：1 张 `first_frame` + 1 张 `last_frame`

        - **多模态参考生视频**：参考图（1~9 张，`reference_type=asset`）+ 参考视频（0~3 段）+ 参考音频（0~3
        段）的任意组合；audio 不可单独使用


        > 首帧 / 首尾帧 / 多模态参考 三种场景**互斥**，不可混用。
      operationId: generateSeedance20Fast
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
              properties:
                model:
                  type: string
                  description: 固定值 `doubao/seedance-2.0-fast`
                prompt:
                  type: string
                  description: |
                    提示词。支持中、英、日、印尼、西、葡语。

                    > 建议中文 ≤ 500 字，英文 ≤ 1000 词；字数过多可能导致模型忽略部分细节。
                  example: >-
                    A slow pan across a misty mountain valley at sunrise,
                    cinematic
                resolution:
                  type: string
                  description: 输出分辨率，默认 `720P`。
                  default: 720P
                  enum:
                    - 480P
                    - 720P
                aspect_ratio:
                  type: string
                  description: |
                    输出宽高比，默认 `adaptive`（由模型按输入素材或提示词自动适配）。
                  default: adaptive
                  enum:
                    - '16:9'
                    - '4:3'
                    - '1:1'
                    - '3:4'
                    - '9:16'
                    - '21:9'
                    - adaptive
                duration:
                  type: integer
                  description: 视频时长（秒），默认 `5`，取值范围 `4 ~ 15` 的整数。
                  default: 5
                  minimum: 4
                  maximum: 15
                generate_audio:
                  type: boolean
                  description: 是否生成与画面同步的声音，默认 `true`。生成的有声视频为单声道。
                  default: true
                reference_images:
                  type: array
                  description: >
                    参考图列表，最多 **9** 张。按 `reference_type` 组合决定输入模式：

                    - **图生视频-首帧**：1 张 `first_frame`

                    - **图生视频-首尾帧**：1 张 `first_frame` + 1 张 `last_frame`

                    - **多模态参考生视频**：1~9 张 `asset`，可与 `reference_videos` /
                    `reference_audios` 组合


                    > 图片要求：格式 `jpeg` / `png` / `webp` / `bmp` / `tiff` /
                    `gif`；单张 ≤ 30 MB；请求体总计 ≤ 64 MB（大文件请勿使用 base64）；宽高边长 300 ~
                    6000 px；宽高比介于 1:2.5 ~ 2.5:1 之间。
                  maxItems: 9
                  items:
                    type: object
                    required:
                      - url
                    properties:
                      url:
                        type: string
                        description: |
                          图片地址，支持两种形式：
                          **1)** 公网可访问 URL（`http://` 或 `https://`）；
                          **2)** Data URI base64（`data:image/` 开头）。
                      reference_type:
                        type: string
                        description: |
                          参考类型：
                          - `asset` — 多模态参考（默认）
                          - `first_frame` — 首帧
                          - `last_frame` — 尾帧
                        default: asset
                        enum:
                          - asset
                          - first_frame
                          - last_frame
                reference_videos:
                  type: array
                  description: >
                    参考视频列表，最多 **3** 段，所有视频总时长 ≤ 15 秒，仅支持公网 URL。


                    > 视频要求：格式 `mp4` / `mov`；分辨率 480P / 720P；单段 2 ~ 15 秒、≤ 50
                    MB；宽高边长 300 ~ 6000 px；宽高比介于 1:2.5 ~ 2.5:1 之间；像素乘积范围
                    [640×640, 834×1112]；FPS 24 ~ 60。
                  maxItems: 3
                  items:
                    type: object
                    required:
                      - url
                    properties:
                      url:
                        type: string
                        description: 公网可访问的视频 URL，不支持 base64。
                      refer_type:
                        type: string
                        description: |
                          参考类型，当前仅支持 `base`（参考视频）。
                        default: base
                        enum:
                          - base
                reference_audios:
                  type: array
                  description: >
                    参考音频列表，最多 **3** 段，所有音频总时长 ≤ 15 秒。**不可单独使用**，必须至少伴随 1 个
                    `reference_image` 或 `reference_video`。


                    > 音频要求：格式 `wav` / `mp3`；单段 2 ~ 15 秒、≤ 15 MB；请求体总计 ≤ 64
                    MB（大文件请勿使用 base64）。
                  maxItems: 3
                  items:
                    type: object
                    required:
                      - url
                    properties:
                      url:
                        type: string
                        description: |
                          音频地址，支持两种形式：
                          **1)** 公网可访问 URL（`http://` 或 `https://`）；
                          **2)** Data URI base64（`data:audio/` 开头）。
                      refer_type:
                        type: string
                        description: |
                          参考类型，当前仅支持 `reference`（参考音频）。
                        default: reference
                        enum:
                          - reference
                extra_params:
                  type: object
                  description: >
                    支持 Seedance 官方扩展参数，全部选填：

                    - `seed` — 整数 `[-1, 2^32-1]`。`-1` 或不传使用随机种子；相同 seed
                    下模型输出会接近但不保证完全一致。

                    - `watermark` — 布尔，默认 `false`。是否在生成视频上添加水印。

                    - `return_last_frame` — 布尔，默认
                    `false`。开启后可通过查询接口拿到生成视频的尾帧图（PNG，无水印，宽高与视频一致），可用于拼接多段连续视频。
                  additionalProperties: true
            examples:
              Text to Video:
                summary: Text to Video
                value:
                  model: doubao/seedance-2.0-fast
                  prompt: >-
                    A slow pan across a misty mountain valley at sunrise,
                    cinematic
                  resolution: 720P
                  aspect_ratio: '16:9'
                  duration: 5
              Image to Video (first frame):
                summary: Image to Video - First Frame
                value:
                  model: doubao/seedance-2.0-fast
                  prompt: The mountain comes alive as birds fly past
                  reference_images:
                    - url: https://example.com/first.jpg
                      reference_type: first_frame
                  resolution: 720P
                  aspect_ratio: adaptive
                  duration: 5
              Multimodal Reference:
                summary: Multimodal Reference (images + video + audio)
                value:
                  model: doubao/seedance-2.0-fast
                  prompt: '[图1] 的苹果和 [图2] 的果茶杯，搭配背景音乐'
                  reference_images:
                    - url: https://example.com/apple.jpg
                      reference_type: asset
                    - url: https://example.com/cup.jpg
                      reference_type: asset
                  reference_videos:
                    - url: https://example.com/reference.mp4
                      refer_type: base
                  reference_audios:
                    - url: https://example.com/bgm.mp3
                      refer_type: reference
                  resolution: 720P
                  aspect_ratio: adaptive
                  duration: 6
                  generate_audio: true
                  extra_params:
                    seed: 42
                    watermark: false
      responses:
        '200':
          description: 提交成功（异步模式）
          content:
            application/json:
              schema:
                type: object
                properties:
                  task_id:
                    type: string
                    description: 任务唯一 ID，用于后续轮询查询
                    example: task_2044275355061448704
                  model:
                    type: string
                    description: 本次任务使用的模型 ID
                    example: doubao/seedance-2.0-fast
                  created_at:
                    type: string
                    description: 任务创建时间（ISO 8601）
                    example: '2026-04-15T04:43:20.233Z'
                  request_id:
                    type: string
                    description: 请求唯一 ID
                    example: 67e2e394-cf6f-4998-b293-ebf20d14dc26
        '400':
          description: Validation Error (e.g. invalid parameter, invalid prompt)
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: Error code
                        example: INVALID_PARAMETER
                      message:
                        type: string
                        description: Error message details
                        example: >-
                          reference_audios must be accompanied by at least one
                          reference_image or reference_video
                      status:
                        type: integer
                        description: HTTP status code
                        example: 400
                      request_id:
                        type: string
                        description: Unique request identifier
                        example: req_abc123
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >
        在请求 Header 中传入 `Authorization: Bearer <YOUR_API_KEY>`。前往 [API Keys
        管理页](https://imini.ai/zh/api-keys) 创建和管理 API Key。

````