# 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/image-to-video:
    post:
      summary: seedance2.0-Fast/图生视频
      deprecated: false
      description: >-
        seedance 2.0 Fast 图生视频，更注重生成速度与性价比。支持首帧图生视频和首尾帧图生视频两种模式，快速将静态图片转化为 4-15
        秒的动态影像。
      operationId: postOpenapiV2RhartVideoSparkvideo20FastImageToVideo
      tags:
        - 模型API/视频生成与处理/image-to-video/seedance2.0
        - 标准模型API/视频生成与处理/image-to-video/seedance2.0
      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: 0
                  maxLength: 20480
                  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'
                firstFrameUrl:
                  type: string
                  format: uri
                  default: >-
                    https://www.runninghub.cn/view?filename=767f5a40041fa18eae8da0ad28a5312c97d6b9e276679dad1a687fbdbf5289a4.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzUwNDE3NjU5NjEsInRzIjoxNzc0NDM2OTY1OTYxLCJzaWduIjoiNDkyODZjYjFiYTBmMWFiYjRkODI4YTBjYTJjYWMzYTAifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.536881616310037
                  description: |-
                    首帧图片

                    支持的文件格式：JPG, JPEG, PNG, WEBP.
                lastFrameUrl:
                  type: string
                  format: uri
                  default: >-
                    https://www.runninghub.cn/view?filename=b8f1f59101a141f8a425378d6cd3a5aba812cec34797aa82822abb1fdc36e380.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzUwNDE3NjU5NjEsInRzIjoxNzc0NDM2OTY1OTYxLCJzaWduIjoiNDkyODZjYjFiYTBmMWFiYjRkODI4YTBjYTJjYWMzYTAifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.4442212472095596
                  description: |-
                    尾帧图片（可选，首尾帧模式）

                    支持的文件格式：JPG, JPEG, PNG, WEBP.
                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
                      - firstFrameUrl
                      - lastFrameUrl
                  default:
                    - all
                  description: 真人素材资产化槽位，多选；all 表示首帧与尾帧都做资产化。
                  x-option-metadata:
                    - value: all
                      description: all
                    - value: firstFrameUrl
                      description: firstFrameUrl
                    - value: lastFrameUrl
                      description: lastFrameUrl
                returnLastFrame:
                  type: boolean
                  default: false
                  description: 是否返回视频尾帧图片
                seed:
                  type: integer
                  minimum: -1
                  maximum: 2147483647
                  multipleOf: 1
                  default: -1
                  description: 种子整数，用于控制生成内容的随机性。
              required:
                - resolution
                - duration
                - firstFrameUrl
              x-apifox-orders:
                - prompt
                - resolution
                - duration
                - firstFrameUrl
                - lastFrameUrl
                - generateAudio
                - ratio
                - realPersonMode
                - conversionSlots
                - returnLastFrame
                - seed
            example:
              resolution: 720p
              duration: '5'
              firstFrameUrl: >-
                https://www.runninghub.cn/view?filename=767f5a40041fa18eae8da0ad28a5312c97d6b9e276679dad1a687fbdbf5289a4.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzUwNDE3NjU5NjEsInRzIjoxNzc0NDM2OTY1OTYxLCJzaWduIjoiNDkyODZjYjFiYTBmMWFiYjRkODI4YTBjYTJjYWMzYTAifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.536881616310037
              lastFrameUrl: >-
                https://www.runninghub.cn/view?filename=b8f1f59101a141f8a425378d6cd3a5aba812cec34797aa82822abb1fdc36e380.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzUwNDE3NjU5NjEsInRzIjoxNzc0NDM2OTY1OTYxLCJzaWduIjoiNDkyODZjYjFiYTBmMWFiYjRkODI4YTBjYTJjYWMzYTAifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.4442212472095596
              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/243d245f33959a7a6a28a756f6ee1402.mp4
                        outputType: mp4
                        text: null
                    clientId: ''
                    promptTips: ''
          headers: {}
      security: []
      x-sku-id: '2034917373414539276'
      x-apifox-folder: 模型API/视频生成与处理/image-to-video/seedance2.0
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/7913447/apis/api-448183115-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://www.runninghub.cn
    description: runninghub.cn
security: []

```
