# seedance2.0-Fast/多模态视频

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /openapi/v2/rhart-video/sparkvideo-2.0-fast/multimodal-video:
    post:
      summary: seedance2.0-Fast/多模态视频
      deprecated: false
      description: >-
        seedance 2.0 Fast
        多模态视频生成，更注重生成速度与性价比。支持多模态参考、视频编辑和视频续写，可组合文本、图片（最多9张）、视频（最多3段）、音频（最多3段）等多模态输入。
      operationId: postOpenapiV2RhartVideoSparkvideo20FastMultimodalVideo
      tags:
        - 模型API/视频生成与处理/reference-to-video
        - 标准模型API/视频生成与处理/reference-to-video
      parameters:
        - name: Content-Type
          in: header
          description: ''
          required: false
          example: application/json
          schema:
            type: string
            default: application/json
        - name: Authorization
          in: header
          description: ''
          required: true
          example: Bearer [Your API KEY]
          schema:
            type: string
            default: Bearer [Your API KEY]
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                prompt:
                  type: string
                  minLength: 1
                  maxLength: 20480
                  default: 把视频中的人物替换成图片中的人物，并延长这段视频
                  description: 视频生成提示词
                resolution:
                  type: string
                  enum:
                    - 480p
                    - 720p
                    - 1080p
                    - 2k
                    - 4k
                  default: 720p
                  description: >-
                    视频分辨率。分为模型原生输出的分辨率（480p、720p），与基于 720p
                    原生生成后进行超分放大的分辨率（1080p、2k、4k）。
                  x-option-metadata:
                    - value: 480p
                      description: 480p
                    - value: 720p
                      description: 720p
                    - value: 1080p
                      description: 1080p
                    - value: 2k
                      description: 2k
                    - value: 4k
                      description: 4k
                duration:
                  type: string
                  enum:
                    - '-1'
                    - '4'
                    - '5'
                    - '6'
                    - '7'
                    - '8'
                    - '9'
                    - '10'
                    - '11'
                    - '12'
                    - '13'
                    - '14'
                    - '15'
                  default: '5'
                  description: 视频时长（秒）
                  x-option-metadata:
                    - value: '-1'
                      description: '-1'
                    - value: '4'
                      description: '4'
                    - value: '5'
                      description: '5'
                    - value: '6'
                      description: '6'
                    - value: '7'
                      description: '7'
                    - value: '8'
                      description: '8'
                    - value: '9'
                      description: '9'
                    - value: '10'
                      description: '10'
                    - value: '11'
                      description: '11'
                    - value: '12'
                      description: '12'
                    - value: '13'
                      description: '13'
                    - value: '14'
                      description: '14'
                    - value: '15'
                      description: '15'
                imageUrls:
                  type: array
                  items:
                    type: string
                    format: uri
                  maxItems: 9
                  default:
                    - >-
                      https://www.runninghub.cn/view?filename=47c88bbf69ce3af8d828ebb22d3818abf6f3b41c720ce4e5666e40386e28c3af.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzU4MzA2ODIzMTYsInRzIjoxNzc1MjI1ODgyMzE2LCJzaWduIjoiNGExYmI0YzEzODc0NWY5MDA2YmNkNmU2NTFhZjkyOGIifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.5589574872824656
                  description: |-
                    参考图片（0-9张）

                    支持的文件格式：JPG, JPEG, PNG, WEBP.
                videoUrls:
                  type: array
                  items:
                    type: string
                    format: uri
                  maxItems: 3
                  default:
                    - >-
                      https://www.runninghub.cn/view?filename=250637b5b0cba889b913eba6c1aae728229e43eadf0abddd739f18f98755162d.mp4&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzUwNTIzNjM4NTksInRzIjoxNzc0NDQ3NTYzODU5LCJzaWduIjoiNWU3OGI4NGY1YWVkY2Q2ZTQ0M2I1ZTEzNjU4ZDM1YjAifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.2053726941224695
                  description: >-
                    参考视频（0-3个，用于多模态参考/视频编辑/视频续写）。单个视频时长 [2, 15] s，最多传入 3
                    个参考视频，所有视频总时长不超过 15s。


                    支持的文件格式：MP4, MOV.
                audioUrls:
                  type: array
                  items:
                    type: string
                    format: uri
                  maxItems: 3
                  default: []
                  description: >-
                    参考音频（0-3个，需至少包含1个参考视频或图片）。单个音频时长 [2, 15] s，最多传入 3
                    段参考音频，所有音频总时长不超过 15 s。


                    支持的文件格式：MP3, WAV.
                generateAudio:
                  type: boolean
                  default: true
                  description: 是否生成视频音频
                ratio:
                  type: string
                  enum:
                    - adaptive
                    - '16:9'
                    - '4:3'
                    - '1:1'
                    - '3:4'
                    - '9:16'
                    - '21:9'
                  default: adaptive
                  description: 视频宽高比
                  x-option-metadata:
                    - value: adaptive
                      description: 自适应
                    - value: '16:9'
                      description: '16:9'
                    - value: '4:3'
                      description: '4:3'
                    - value: '1:1'
                      description: '1:1'
                    - value: '3:4'
                      description: '3:4'
                    - value: '9:16'
                      description: '9:16'
                    - value: '21:9'
                      description: '21:9'
                realPersonMode:
                  type: boolean
                  default: true
                  description: 真人模式，开启后系统会自动将图片/视频/音频转为火山资产（asset://），提升生成效果。
                conversionSlots:
                  type: array
                  items:
                    type: string
                    enum:
                      - all
                      - image1
                      - image2
                      - image3
                      - image4
                      - image5
                      - image6
                      - image7
                      - image8
                      - image9
                      - video1
                      - video2
                      - video3
                  default:
                    - all
                  description: 真人素材资产化槽位，多选；all 表示所有图片/视频槽位都做资产化。
                  x-option-metadata:
                    - value: all
                      description: all
                    - value: image1
                      description: image1
                    - value: image2
                      description: image2
                    - value: image3
                      description: image3
                    - value: image4
                      description: image4
                    - value: image5
                      description: image5
                    - value: image6
                      description: image6
                    - value: image7
                      description: image7
                    - value: image8
                      description: image8
                    - value: image9
                      description: image9
                    - value: video1
                      description: video1
                    - value: video2
                      description: video2
                    - value: video3
                      description: video3
                returnLastFrame:
                  type: boolean
                  default: false
                  description: 是否返回视频尾帧图片
                seed:
                  type: integer
                  minimum: -1
                  maximum: 2147483647
                  multipleOf: 1
                  default: -1
                  description: 种子整数，用于控制生成内容的随机性。
              required:
                - prompt
                - resolution
                - duration
              x-apifox-orders:
                - prompt
                - resolution
                - duration
                - imageUrls
                - videoUrls
                - audioUrls
                - generateAudio
                - ratio
                - realPersonMode
                - conversionSlots
                - returnLastFrame
                - seed
            example:
              prompt: 把视频中的人物替换成图片中的人物，并延长这段视频
              resolution: 720p
              duration: '5'
              imageUrls:
                - >-
                  https://www.runninghub.cn/view?filename=47c88bbf69ce3af8d828ebb22d3818abf6f3b41c720ce4e5666e40386e28c3af.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzU4MzA2ODIzMTYsInRzIjoxNzc1MjI1ODgyMzE2LCJzaWduIjoiNGExYmI0YzEzODc0NWY5MDA2YmNkNmU2NTFhZjkyOGIifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.5589574872824656
              videoUrls:
                - >-
                  https://www.runninghub.cn/view?filename=250637b5b0cba889b913eba6c1aae728229e43eadf0abddd739f18f98755162d.mp4&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzUwNTIzNjM4NTksInRzIjoxNzc0NDQ3NTYzODU5LCJzaWduIjoiNWU3OGI4NGY1YWVkY2Q2ZTQ0M2I1ZTEzNjU4ZDM1YjAifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.2053726941224695
              generateAudio: true
              ratio: adaptive
              realPersonMode: true
              conversionSlots:
                - all
              returnLastFrame: false
              seed: -1
      responses:
        '200':
          x-apifox-name: 成功
          x-apifox-ordering: 0
          description: <Icon icon="material-outline-info"/> 任务结果查询接口：`/openapi/v2/query`
          content:
            application/json:
              schema:
                type: object
                properties:
                  taskId:
                    type: string
                    description: 任务 ID，用于后续查询任务结果。
                  status:
                    type: string
                    enum:
                      - QUEUED
                      - RUNNING
                      - SUCCESS
                      - FAILED
                    description: 任务状态。
                  errorCode:
                    type: string
                    description: 错误码。
                  errorMessage:
                    type: string
                    description: 错误信息。
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                          description: 输出文件 URL。
                          nullable: true
                        outputType:
                          type: string
                          description: 输出类型或文件扩展名。
                          nullable: true
                        text:
                          type: string
                          description: 文本输出内容。
                          nullable: true
                      x-apifox-orders:
                        - url
                        - outputType
                        - text
                    description: 任务输出结果列表；处理中时可能为 null。
                    nullable: true
                  clientId:
                    type: string
                    description: 客户端标识。
                  promptTips:
                    type: string
                    description: 提示词执行反馈，使用 JSON 字符串承载。
                  failedReason:
                    type: object
                    additionalProperties: true
                    description: 失败详情对象。
                    x-apifox-orders: []
                    nullable: true
                  usage:
                    type: object
                    description: 计费与耗时信息。
                    properties:
                      thirdPartyConsumeMoney:
                        type: string
                        description: 第三方消耗金额。
                        nullable: true
                      consumeMoney:
                        type: string
                        description: 平台消耗金额。
                        nullable: true
                      consumeCoins:
                        type: string
                        description: 平台消耗点数。
                        nullable: true
                      taskCostTime:
                        type: string
                        description: 任务耗时。
                        nullable: true
                    x-apifox-orders:
                      - thirdPartyConsumeMoney
                      - consumeMoney
                      - consumeCoins
                      - taskCostTime
                    nullable: true
                required:
                  - taskId
                  - status
                  - errorCode
                  - errorMessage
                  - results
                  - clientId
                  - promptTips
                x-apifox-orders:
                  - taskId
                  - status
                  - errorCode
                  - errorMessage
                  - results
                  - clientId
                  - promptTips
                  - failedReason
                  - usage
              examples:
                taskSubmitted:
                  summary: 提交任务响应示例
                  value:
                    taskId: '2013508786110730241'
                    status: RUNNING
                    errorCode: ''
                    errorMessage: ''
                    results: null
                    clientId: f828b9af25161bc066ef152db7b29ccc
                    promptTips: >-
                      {"result": true, "error": null, "outputs_to_execute":
                      ["4"], "node_errors": {}}
                taskSucceeded:
                  summary: 任务完成（查询状态接口）响应示例
                  value:
                    taskId: '2013508786110730241'
                    status: SUCCESS
                    errorCode: ''
                    errorMessage: ''
                    failedReason: {}
                    usage:
                      consumeMoney: null
                      consumeCoins: null
                      taskCostTime: '0'
                      thirdPartyConsumeMoney: null
                    results:
                      - url: >-
                          https://rh-images-1252422369.cos.ap-beijing.myqcloud.com/22820eb19d5010de41dbf6856e984340/2026-06-12/d9daadeb52277080df8bebf6f5308ae8.mp4
                        outputType: mp4
                        text: null
                    clientId: ''
                    promptTips: ''
          headers: {}
      security: []
      x-sku-id: '2034917373414539278'
      x-apifox-folder: 模型API/视频生成与处理/reference-to-video
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/7913447/apis/api-448183128-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://www.runninghub.cn
    description: runninghub.cn
security: []

```
