> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crun.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 Fast 参考生视频支持使用您自行上传的素材。"

[//]: #

[//]: # "1. 通过 [Seedance 素材上传 API](/zh/models/seedance/asset-upload) 上传源素材"

[//]: # "2. 查询 [Seedance 素材信息 API](/zh/models/seedance/asset-info)，直到 `Status` 变为 `Active`"

[//]: # "3. 将返回的 `AssetId` 传入 `reference_images`、`reference_videos` 或 `reference_audios`"

[//]: #

[//]: # "<Tip>"

[//]: # "  这些字段也支持普通公开 URL。对于上传的图片、视频和音频素材，仅支持 URL 上传，不支持 Base64。  "

[//]: # "  如果参考图片或参考视频中包含真人面孔，建议先上传到素材库完成审核，以提高生成成功率。"

[//]: # "</Tip>"

[//]: #

[//]: # "## 使用上传素材的请求示例"

[//]: #

[//]: # "```json"

[//]: # "{"

[//]: # "  \"model\": \"bytedance/seedance2-0-fast-r2v\","

[//]: # "  \"callback_url\": \"https://your-domain.com/api/callback\","

[//]: # "  \"input\": {"

[//]: # "    \"prompt\": \"[Image1] the boy wearing glasses and a blue T-shirt and the corgi from [Image2] sit on the lawn from [Image3] in a 3D cartoon style, with background audio based on [Audio1].\","

[//]: # "    \"reference_images\": ["

[//]: # "      \"asset://asset-20260224185115-jtzz8\","

[//]: # "      \"asset://asset-20260224185203-r8k2m\","

[//]: # "      \"asset://asset-20260224185221-q6w7n\""

[//]: # "    ],"

[//]: # "    \"reference_audios\": ["

[//]: # "      \"asset://asset-20260224185411-k3n6x\""

[//]: # "    ],"

[//]: # "    \"resolution\": \"720p\","

[//]: # "    \"aspect_ratio\": \"16:9\","

[//]: # "    \"duration\": 8,"

[//]: # "    \"audio\": true,"

[//]: # "    \"return_last_frame\": false"

[//]: # "  }"

[//]: # "}"

[//]: # "```"

## 查询任务状态

提交任务后，请使用统一查询接口查看进度并获取结果：

<Card title="获取任务信息" icon="magnifying-glass" href="/zh/models/common/get-task-info">
  了解如何查询任务状态并获取生成结果
</Card>

<Tip>
  生产环境中，建议使用 `callback_url` 参数接收任务完成后的自动通知，而不是轮询状态接口。
</Tip>

## 相关资源

<CardGroup cols={2}>
  <Card title="素材上传" icon="upload" href="/zh/models/seedance/asset-upload">
    在 Seedance 请求前上传自定义素材
  </Card>

  <Card title="素材信息" icon="magnifying-glass" href="/zh/models/seedance/asset-info">
    等待上传素材变为可用
  </Card>

  <Card title="模型概览" icon="store" href="/zh/models/quickstart">
    查看所有可用模型
  </Card>

  <Card title="通用 API" icon="gear" href="/zh/common-api/get-account-credits">
    查询账户剩余积分
  </Card>
</CardGroup>


## OpenAPI

````yaml zh/models/seedance/2-0-fast/reference-to-video.json post /api/v1/client/job/CreateTask
openapi: 3.0.0
info:
  title: Crun Seedance 接口
  description: crun.ai Seedance 接口文档
  version: 1.0.0
  contact:
    name: Technical Support
    email: support@crun.ai
servers:
  - url: https://api.crun.ai
    description: API 服务器
security:
  - ApiKeyAuth: []
paths:
  /api/v1/client/job/CreateTask:
    post:
      summary: 使用 Seedance 2.0 Fast 生成视频
      operationId: bytedance/seedance2-0-fast-r2v
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - input
              properties:
                model:
                  type: string
                  enum:
                    - bytedance/seedance2-0-fast-r2v
                  description: |-
                    本接口使用的模型名称，为必填项。

                    - 当前接口仅支持传入 `bytedance/seedance2-0-fast-r2v`
                callback_url:
                  type: string
                  format: uri
                  description: |-
                    可选。任务完成后的回调地址。

                    - 生成完成后，系统会向该地址发送 POST 请求，回传任务状态和结果
                    - 回调载荷结构与任务状态查询接口返回的 `data` 对象保持一致
                    - 你的回调接口应支持接收 JSON 格式的 POST 请求
                    - 成功接收后应返回 HTTP 200 状态码
                  example: https://your-domain.com/api/callback
                input:
                  type: object
                  description: >-
                    参考生视频任务的输入参数（Seedance 2.0 Fast）。`reference_images` 或
                    `reference_videos` 至少需要提供一个。
                  properties:
                    prompt:
                      type: string
                      description: >-
                        用于描述目标场景、动作以及参考素材使用方式的文本提示词。你可以在自然语言中使用 `[Image1]` /
                        `[图1]`、`[Video1]` / `[视频1]`、`[Audio1]` / `[音频1]`
                        等占位符，明确引用已上传素材。例如：`[Image1] 中戴眼镜、穿蓝色 T 恤的男孩和 [Image2]
                        中的柯基坐在 [Image3] 的草坪上，采用 3D 卡通风格，并使用 [Audio1] 作为背景音频。`
                      minLength: 1
                      maxLength: 5000
                      example: >-
                        Create a fashion commercial shot that preserves the
                        model's appearance from the reference images, follows
                        the walking rhythm of the reference video, and matches
                        the mood of the reference audio.
                    reference_images:
                      type: array
                      description: >-
                        可选参考图片，用于约束主体身份、风格、服饰或场景细节。数组中的每一项都必须是公开可访问的图片 URL，或状态为
                        `Active` 的已上传 `AssetId`。如果 `byteplus_fallback` 设为
                        `true`，该字段不支持使用 `asset://` 开头的素材 ID，请改用公开可访问的图片
                        URL。自定义素材可通过 [Seedance 素材上传
                        API](/models/seedance/asset-upload) 上传，并通过 [Seedance
                        素材信息 API](/models/seedance/asset-info) 查询状态。


                        每张图片需满足以下要求：

                        - 输入方式：仅支持公开 URL 或状态为 `Active` 的已上传 `AssetId`

                        - 不支持 Base64

                        - 格式：jpeg、png、webp、bmp、tiff、gif、heic、heif

                        - 宽高比（宽 / 高）：大于 0.4 且小于 2.5

                        - 宽高范围：300 到 6000 像素

                        - 文件大小：单张图片小于 30 MB
                      items:
                        type: string
                        format: uri
                        example: https://example.com/reference-image-1.png
                      maxItems: 9
                      example:
                        - https://example.com/reference-image-1.png
                        - https://example.com/reference-image-2.png
                    reference_videos:
                      type: array
                      description: >-
                        可选参考视频，用于引导动作节奏、镜头语言或运动方式。数组中的每一项都必须是公开可访问的视频 URL，或状态为
                        `Active` 的已上传 `AssetId`。如果 `byteplus_fallback` 设为
                        `true`，该字段不支持使用 `asset://` 开头的素材 ID，请改用公开可访问的视频
                        URL。自定义素材可通过 [Seedance 素材上传
                        API](/models/seedance/asset-upload) 上传，并通过 [Seedance
                        素材信息 API](/models/seedance/asset-info) 查询状态。


                        每个视频需满足以下要求：

                        - 输入方式：仅支持公开 URL 或状态为 `Active` 的已上传 `AssetId`

                        - 不支持 Base64

                        - 格式：mp4、mov

                        - 分辨率：480p 或 720p

                        - 单段时长：2 到 15 秒

                        - 最多支持 3 段参考视频，总时长不超过 15 秒

                        - 宽高比（宽 / 高）：0.4 到 2.5

                        - 宽高范围：300 到 6000 像素

                        - 总像素（宽 × 高）：409600 到 927408

                        - 文件大小：单个视频不超过 50 MB

                        - 帧率：24 到 60 FPS
                      items:
                        type: string
                        format: uri
                        example: https://example.com/reference-video-1.mp4
                      maxItems: 3
                      example:
                        - https://example.com/reference-video-1.mp4
                    reference_audios:
                      type: array
                      description: >-
                        可选参考音频，用于引导节奏或声音设计。如需在输出结果中返回音频，请将 `audio` 字段设置为
                        `true`。数组中的每一项都必须是公开可访问的音频 URL，或状态为 `Active` 的已上传
                        `AssetId`。如果 `byteplus_fallback` 设为 `true`，该字段不支持使用
                        `asset://` 开头的素材 ID，请改用公开可访问的音频 URL。自定义素材可通过 [Seedance
                        素材上传 API](/models/seedance/asset-upload) 上传，并通过
                        [Seedance 素材信息 API](/models/seedance/asset-info) 查询状态。


                        每段音频需满足以下要求：

                        - 输入方式：仅支持公开 URL 或状态为 `Active` 的已上传 `AssetId`

                        - 不支持 Base64

                        - 格式：wav、mp3

                        - 单段时长：2 到 15 秒

                        - 最多支持 3 段参考音频，总时长不超过 15 秒

                        - 文件大小：单段音频不超过 15 MB
                      items:
                        type: string
                        format: uri
                        example: https://example.com/reference-audio-1.mp3
                      maxItems: 3
                      example:
                        - https://example.com/reference-audio-1.mp3
                    byteplus_fallback:
                      type: boolean
                      description: >-
                        是否启用海外版兜底。启用后，`img_urls`、`reference_images`、`reference_videos`
                        等资源地址参数不支持使用 `asset://` 开头的素材 ID，请改用公开可访问的资源 URL。
                      default: false
                      example: false
                    return_last_frame:
                      type: boolean
                      deprecated: true
                      description: 是否返回生成视频的最后一帧
                      default: false
                      example: false
                    audio:
                      type: boolean
                      description: 是否为输出视频生成同步音频
                      default: false
                      example: true
                    resolution:
                      type: string
                      description: 输出视频分辨率
                      enum:
                        - 480p
                        - 720p
                      default: 720p
                      example: 720p
                    aspect_ratio:
                      type: string
                      description: 生成视频的宽高比
                      enum:
                        - '1:1'
                        - '9:16'
                        - '16:9'
                        - '3:4'
                        - '4:3'
                        - '21:9'
                        - auto
                      default: auto
                      example: '16:9'
                    duration:
                      type: integer
                      description: 视频时长，单位为秒。支持 4 到 15 的任意整数
                      minimum: 4
                      maximum: 15
                      default: 5
                      example: 8
                  required:
                    - prompt
                  anyOf:
                    - required:
                        - reference_images
                    - required:
                        - reference_videos
            example:
              model: bytedance/seedance2-0-fast-r2v
              callback_url: https://your-domain.com/api/callback
              input:
                prompt: >-
                  [Image1] the boy wearing glasses and a blue T-shirt and the
                  corgi from [Image2] sit on the lawn from [Image3] in a 3D
                  cartoon style, with background audio based on [Audio1].
                reference_images:
                  - https://example.com/reference-image-1.png
                  - https://example.com/reference-image-2.png
                  - https://example.com/reference-image-3.png
                reference_audios:
                  - https://example.com/reference-audio-1.mp3
                resolution: 720p
                aspect_ratio: '16:9'
                duration: 8
                audio: true
                byteplus_fallback: false
                return_last_frame: false
      responses:
        '200':
          description: 请求成功
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponse'
                  - type: object
                    properties:
                      data:
                        type: object
                        properties:
                          task_id:
                            type: string
                            description: 任务 ID，可用于通过任务详情接口查询任务状态
                            example: task_12345678
              example:
                code: 200
                message: success
                data:
                  task_id: task_12345678
        '422':
          description: 参数校验错误
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponse'
                  - type: object
                    properties:
                      errors:
                        type: array
                        description: 详细的参数校验错误信息
                        items:
                          type: string
                        example:
                          - specific error field message
              example:
                code: 422
                message: Missing Params or Type Error
                errors:
                  - specific error field message
        '500':
          $ref: '#/components/responses/Error'
components:
  schemas:
    ApiResponse:
      type: object
      properties:
        code:
          type: integer
          enum:
            - 200
            - 401
            - 402
            - 404
            - 422
            - 429
            - 455
            - 500
            - 501
            - 505
          description: |-
            响应状态码

            - **200**：成功，请求已成功处理
            - **401**：未授权，缺少认证信息或认证无效
            - **402**：额度不足，账户额度不足以完成本次操作
            - **404**：资源不存在，请求的资源或接口不存在
            - **422**：参数校验错误，请求参数未通过校验
            - **429**：请求过于频繁，已超出当前资源的调用限制
            - **455**：服务不可用，系统当前正在维护中
            - **500**：服务器错误，处理请求时发生了意外错误
            - **501**：生成失败，内容生成任务执行失败
            - **505**：功能已禁用，请求的功能当前不可用
        message:
          type: string
          description: 响应消息；失败时为错误说明
          example: success
  responses:
    Error:
      description: 服务器错误
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: |-
        所有接口均需通过 API Key 进行认证。

        获取 API Key：
        1. 访问 [API Key 管理页面](https://crun.ai/zh/user-api-key) 获取你的 API Key

        使用方式：
        在请求头中添加：

        x-api-key: YOUR_API_KEY

        注意事项：
        - 请妥善保管你的 API Key，不要泄露给他人
        - 如果怀疑 API Key 已泄露，请立即在管理页面中重置

````