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

Seedance 2.5 图生视频 API

POST /v1/tasks

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

模型概览

模型 seedance-2.5/image-to-video
能力 首帧 / 首尾帧图生视频
分辨率 480p / 720p
时长 4-30 秒

使用首帧或首尾帧图片生成最长 30 秒视频，输出比例自动跟随首帧，并支持同步音频。

生产建议

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

适用场景

图片动画化

让海报、产品图、插画或场景图产生自然镜头运动。

first_frame_url
首尾帧过渡

同时指定起始和结束画面，控制一段完整的转场。

first_frame_urllast_frame_url
有声短片

为图像驱动的镜头生成同步台词、音效和背景音乐。

generate_audio

请求参数

model string 必填

模型 ID。

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

首帧或首尾帧图生视频参数。

prompt string 必填

动作、镜头、场景和声音描述。支持中文、英语、西班牙语、印度尼西亚语、葡萄牙语、日语、马来语、泰语、阿拉伯语、越南语和韩语。

first_frame_url string 可选

首帧图片 URL、data URL 或素材 ID。支持 jpeg、png、webp、bmp、tiff、gif、heic、heif；单张小于 30 MB；边长 300-6000 px；宽高比 0.4-2.5；不支持 SVG。

last_frame_url string 可选

尾帧图片 URL，与 first_frame_url 配合使用。宽高比不一致时，尾帧会居中裁剪以匹配首帧。

reference_image_urls string[] 可选

参考图片 URL 数组，最多 30 张，用于补充主体、风格或构图参考。不支持 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
generate_audio boolean 可选

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

默认 true
output_format enum 可选

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

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

是否在视频右下角添加“AI 生成”水印。

默认 false
web_search boolean 可选

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

默认 false
callback object 可选

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

url string 必填

接收终态通知的 HTTPS 地址。

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

任务终态时触发。

默认 final 可选值: final

用例示例

首帧生视频

只传首帧图片，模型自动生成动作和镜头。

请求体
{
  "model": "seedance-2.5/image-to-video",
  "input": {
    "prompt": "镜头从静止到缓慢环绕",
    "first_frame_url": "https://example.com/first-frame.jpg",
    "resolution": "720p",
    "duration": 6,
    "aspect_ratio": "adaptive"
  }
}
首尾帧转场

指定首帧和尾帧，生成两张图片之间的连贯过渡。

请求体
{
  "model": "seedance-2.5/image-to-video",
  "input": {
    "prompt": "自然完成从白天到夜晚的时间流逝",
    "first_frame_url": "https://example.com/day.jpg",
    "last_frame_url": "https://example.com/night.jpg",
    "resolution": "480p",
    "duration": 8,
    "aspect_ratio": "adaptive",
    "generate_audio": false
  }
}

获取结果

  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 直接就是任务对象。

只传 first_frame_url 可以吗？

可以。last_frame_url 是可选的；只传首帧时模型自动生成后续画面。

什么时候使用参考生视频模型？

需要参考视频引导动作或运镜时，使用 seedance-2.5/reference-to-video；首尾帧、参考图片和参考音频可直接使用本模型。

下一步