跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Seedance 2.5 参考生视频 API

POST /v1/tasks

图片、视频和音频模型通过 统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型 seedance-2.5/reference-to-video
能力 多模态参考生视频
参考素材 图片 / 视频 / 音频
时长 4-30 秒

使用 1-10 段参考视频生成最长 30 秒视频，可叠加参考图片和参考音频。

生产建议

调用建议
  • 生产环境可通过 callback.url 接收终态通知，并用 GET /v1/tasks/:id 做补偿查询。
  • 产物 URL 有有效期，需要长期保存时请转存到自己的存储。

适用场景

主体与风格参考

用参考图片保持主体、服装、产品或美术风格的一致性。

reference_image_urls
运镜与动作参考

用参考视频提供动作节奏、运镜方式和场景变化。

reference_video_urls
声音参考

结合参考音频控制声音风格。

reference_audio_urls

请求参数

model string 必填

模型 ID。

示例 seedance-2.5/reference-to-video
input object 必填

多模态参考生视频参数。

prompt string 必填

补充动作、镜头和场景要求。按传入顺序使用 @image1、@video1、@audio1 指代素材。本模型不支持视频编辑或延长。

reference_video_urls string[] 必填

参考视频 URL 数组，支持 1-10 段。格式为 mp4 或 mov；每段 2-30 秒、单段不超过 200 MB、24-60 fps；总时长不超过 30 秒。

reference_image_urls string[] 可选

参考图片 URL 数组，最多 30 张。支持 jpeg、png、webp、bmp、tiff、gif、heic、heif；单张小于 30 MB；边长 300-6000 px；宽高比 0.4-2.5；不支持 SVG。

reference_audio_urls string[] 可选

参考音频 URL 数组，最多 10 段。格式为 wav 或 mp3；每段 2-30 秒、单段不超过 15 MB；总时长不超过 30 秒。

resolution enum 可选

输出视频分辨率，默认 480p。

默认 480p 可选值: 480p720p
duration integer 可选

输出视频时长，单位为秒，支持 4-30 的整数，默认 5 秒。

默认 5
aspect_ratio enum 可选

输出宽高比。adaptive 会根据提示词和参考素材自动适配。

默认 adaptive 可选值: 16:94:31:13:49:1621:9adaptive
generate_audio boolean 可选

是否生成与画面同步的人声、音效和背景音乐。

默认 true
output_format enum 可选

输出格式。mp4 兼容性更好；mov 适合专业后期。

默认 mp4 可选值: mp4mov
web_search boolean 可选

是否允许模型检索提示词中的时效信息。

默认 false
callback object 可选

任务进入终态时发送任务对象；轮询接口则把同一个任务对象放在 data 中。

url string 必填

接收终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

任务终态时触发。

默认 final 可选值: final

用例示例

视频与图片组合参考

用动作视频和主体图片共同控制生成。

请求体
{
  "model": "seedance-2.5/reference-to-video",
  "input": {
    "prompt": "保持主体外观并沿着海岸线平稳向前移动",
    "reference_video_urls": [
      "https://example.com/camera-motion.mp4"
    ],
    "reference_image_urls": [
      "https://example.com/subject.jpg"
    ],
    "resolution": "720p",
    "duration": 6,
    "aspect_ratio": "16:9"
  }
}
视频与音频组合参考

同时使用动作视频和声音参考。

请求体
{
  "model": "seedance-2.5/reference-to-video",
  "input": {
    "prompt": "保留动作节奏，替换为城市夜景",
    "reference_video_urls": [
      "https://example.com/motion.mp4"
    ],
    "reference_audio_urls": [
      "https://example.com/voice.wav"
    ],
    "resolution": "480p",
    "duration": 8,
    "aspect_ratio": "adaptive"
  }
}
最多十段参考视频

可在数组中传入 1-10 段参考视频，总时长不超过 30 秒。

请求体
{
  "model": "seedance-2.5/reference-to-video",
  "input": {
    "prompt": "融合这些片段的运镜节奏，生成一段连贯的新场景",
    "reference_video_urls": [
      "https://example.com/clip-01.mp4",
      "https://example.com/clip-02.mp4"
    ],
    "resolution": "720p",
    "duration": 10,
    "aspect_ratio": "adaptive"
  }
}

获取结果

  1. 创建任务响应从 data.taskId 读取任务 ID。
  2. 等待 callback，或调用 GET /v1/tasks/:id 查询状态；轮询响应从 data 读取任务对象。
  3. status=success 时，从 output 中读取 type=video 的视频 URL；callback body 直接读取 output。

常见问题

callback 和轮询的返回格式有什么区别？

任务对象字段一致，但 HTTP 包装不同：轮询响应从 data 读取任务对象，callback body 直接就是任务对象。

参考视频和音频会改变输出时长吗？

不会。输出时长由 duration 决定，参考素材只用于控制内容。

下一步