Seedance 2.5 参考生视频 API
POST Base URL:
https://api.hiapi.ai /v1/tasks 图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。
模型概览
| 模型 | seedance-2.5/reference-to-video |
|---|---|
| 能力 | 多模态参考生视频 |
| 参考素材 | 图片 / 视频 / 音频 |
| 输出时长 | 4-30 秒，或 -1 自动选择 |
用参考视频引导动作和运镜，生成新的视频。可搭配图片指定主体与风格，或加入音频作为声音参考。
生产建议
获取并保存视频
- 提交后会返回 taskId。用它查询任务进度，或设置 callback.url 接收完成通知。
- 视频链接有有效期，请及时下载需要保留的文件。
适用场景
主体与风格参考
用参考图片保持主体、服装、产品或美术风格的一致性。
reference_image_urls运镜与动作参考
用参考视频提供动作节奏、运镜方式和场景变化。
reference_video_urls声音参考
在参考视频之外加入音频，提供声音风格参考。
reference_audio_urls请求参数
model string 必填 模型 ID。
input object 必填 填写提示词、参考素材和生成设置。
prompt string 必填 描述希望生成的画面、动作和运镜。用 @video1、@image1、@audio1 引用对应素材，编号与各类素材的传入顺序一致。
reference_video_urls string[] 必填 参考视频，为新视频提供动作、运镜和场景参考。传入可公开访问的 HTTPS 地址。
- 支持格式
- 数量与大小
- 1-10 段每段小于 200 MB
- 时长与帧率
- 每段 2-30 秒，合计不超过 30 秒24-60 fps
- 画面尺寸
- 至少 409600 像素，如 854×480边长 300-6000 px，宽高比 0.4-2.5
reference_image_urls string[] 可选 参考图片，用于指定主体外观、构图或画面风格。支持 HTTP(S) 地址和 data URL。
- 支持格式
- 数量与大小
- 最多 30 张单张小于 30 MB，合计不超过 120 MB
- 画面尺寸
- 边长 300-6000 px宽高比 0.4-2.5
- 动图处理
- GIF 仅使用第一帧
- 不支持
reference_audio_urls string[] 可选 参考音频，用于提供声音风格参考，需与参考视频一起使用。
- 支持格式
- 数量与大小
- 最多 10 段每段小于 15 MB
- 时长
- 每段 2-30 秒，合计不超过 30 秒
resolution enum 可选 输出视频分辨率。
duration integer 可选 生成视频的时长，单位为秒。
- 自动选择
- 传入 -1，由模型决定时长
- 指定时长
- 传入 4-30 的整数
aspect_ratio enum 可选 输出宽高比。adaptive 会根据提示词和参考素材自动适配。
generate_audio boolean 可选 是否生成与画面同步的人声、音效和背景音乐。
output_format enum 可选 输出格式。mp4 兼容性更好；mov 适合专业后期。
web_search boolean 可选 是否允许模型联网搜索提示词中提到的信息。
callback object 可选 任务完成或失败时，向指定地址发送结果通知。
url string 必填 接收结果通知的 HTTPS 地址。
when enum 可选 通知发送时机。
用例示例
参考视频与自动时长
将示例 URL 替换为可公开访问的参考视频地址。传 duration=-1，让模型自行选择输出时长。
请求体
{
"model": "seedance-2.5/reference-to-video",
"input": {
"prompt": "参考 @video1 的花朵、色彩和近景构图，生成花朵在微风中轻轻摇动的自然镜头，不要文字、标志或人物。",
"reference_video_urls": [
"https://example.com/reference-video.mp4"
],
"resolution": "480p",
"duration": -1,
"aspect_ratio": "16:9",
"generate_audio": false
}
}视频与图片组合参考
用动作视频和主体图片共同控制生成。
请求体
{
"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": "参考 @video1 的动作节奏和 @audio1 的声音风格，生成城市夜景中的新镜头。",
"reference_video_urls": [
"https://example.com/motion.mp4"
],
"reference_audio_urls": [
"https://example.com/voice.wav"
],
"resolution": "480p",
"duration": 8,
"aspect_ratio": "adaptive"
}
}多段运镜参考
传入多段视频，并在提示词中说明如何使用各段素材。
请求体
{
"model": "seedance-2.5/reference-to-video",
"input": {
"prompt": "参考 @video1 的平稳跟拍和 @video2 的环绕运镜，生成一段连贯的新场景。",
"reference_video_urls": [
"https://example.com/clip-01.mp4",
"https://example.com/clip-02.mp4"
],
"resolution": "720p",
"duration": 10,
"aspect_ratio": "adaptive"
}
}获取结果
- 从提交响应的 data.taskId 获取任务 ID。
- 调用 GET /v1/tasks/:id 查询进度，或等待回调通知。查询结果位于 data 中，回调通知直接包含任务结果。
- 任务状态为 success 时，在 output 数组中找到 type 为 video 的项，读取 url 即可下载视频。
常见问题
如何设置自动时长？
将 input.duration 设为 -1。模型会根据提示词和参考素材选择生成视频的时长。
可以只传图片或音频吗？
不可以，这个接口至少需要一段参考视频。图片和音频是可选的补充素材；只使用图片时，请选择图生视频接口。
参考图片尺寸不符合要求时会收费吗？
不会。图片尺寸或宽高比不符合要求时，请求会返回 HTTP 400，不会创建任务或产生费用。