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

Seedance 2.5 图生视频 API

POST Base URL: https://api.hiapi.ai /v1/tasks

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

模型概览

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

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

生产建议

调用建议
  • 提供 last_frame_url 时，同时提供 first_frame_url。
  • 使用 callback.url 接收任务完成或失败通知；查询响应从 data 读取任务对象，回调正文直接读取任务对象。
  • 产物 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 可选

首帧图片 HTTP(S) URL、data URL 或 asset://<id> 素材 ID。首帧或首尾帧输入不能同时使用参考图片或参考音频。

last_frame_url string 可选

尾帧图片 URL，与 first_frame_url 配合使用。与首帧比例不一致时会居中裁剪；首尾帧输入不能同时使用参考图片或参考音频。

reference_image_urls string[] 可选

参考图片 URL 数组，最多 30 张，用于补充主体、风格或构图参考。参考图片不能与首帧或尾帧同时使用。

reference_audio_urls string[] 可选

参考音频 URL 数组，最多 10 段，用于声音风格或语音参考。参考音频不能与首帧或尾帧同时使用。

resolution enum 可选

输出视频分辨率。

默认 720p 可选值: 720p1080p
duration integer 可选

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

默认 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": "720p",
    "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 和轮询分别从哪里读取任务？

查询响应从 data 读取任务对象，callback 正文直接读取任务对象。

只传 first_frame_url 可以吗？

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

图片宽高比和 aspect_ratio 有什么区别？

输入图片的宽高比须为 0.4–2.5；aspect_ratio=adaptive 表示输出视频比例跟随首帧图片。

首尾帧可以和参考图片或参考音频一起传吗？

不可以。首帧/首尾帧与参考图片、参考音频不能同时使用。首帧和首尾帧模式仍可设置 generate_audio=true，生成与画面同步的声音。

下一步