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

Seedance 2.0

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

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

模型概览

模型 seedance-2.0
能力 文生视频 / 图生视频 / 多模态参考
线路 标准 / ext

Seedance 2.0 在同一模型下提供标准与 ext 两条线路。通过顶层 route 选择线路，不需要改 model 名称。

生产建议

生产环境建议
  • 生产环境建议传 callback.url 接收任务终态，轮询作为补偿。
  • 标准与 ext 的分辨率、参考素材能力和价格不同；切换 route 时要按对应参数表校验请求。
  • 价格以 HiAPI 实时定价页为准，不要在业务代码里写死。

适用场景

标准线路

需要 480p 或参考视频时使用；同时支持图片、视频和音频参考。

reference_video_urlsresolution
ext 线路

提供 720p、1080p、4k 分辨率档，并支持图片和音频参考。

routeresolution
首帧/首尾帧

用 first_frame_url 和 last_frame_url 控制画面起止。

first_frame_urllast_frame_url
同步音频

需要模型生成同步音频时开启 generate_audio。

generate_audio

请求参数

模型线路

标准线路：支持 480p / 720p / 1080p / 4k，并支持参考图片、参考视频和参考音频。默认不传 route。

model string 必填

固定填 seedance-2.0。

示例 seedance-2.0
route string 可选

标准线路可不传，或显式传 default。

示例 default
input object 必填

Seedance 2.0 的视频生成参数。

prompt string 必填

视频生成提示词，3-20000 字符。

aspect_ratio enum 必填

视频画面比例。adaptive 在图生视频时跟随输入图片比例，文生视频时回退到默认比例。

默认 16:9 可选值: 1:14:33:416:99:1621:9adaptive
duration integer 可选

视频时长，4-15 秒。

默认 5
resolution enum 可选

视频分辨率；支持 480p、720p、1080p 和 4k。

默认 720p 可选值: 480p720p1080p4k
first_frame_url string 可选

首帧图片 URL 或素材 ID。不支持 SVG。

last_frame_url string 可选

尾帧图片 URL 或素材 ID；使用时需同时传首帧。

reference_image_urls string[] 可选

参考图片 URL 列表；与首尾帧图片合计不超过 9 张。不支持 SVG。

reference_video_urls string[] 可选

参考视频 URL 列表，最多 3 个。

reference_audio_urls string[] 可选

参考音频 URL 列表，最多 3 段。

return_last_frame boolean 可选

是否返回视频最后一帧图片。

默认 false
generate_audio boolean 可选

是否生成同步音频。

默认 true
web_search boolean 可选

是否启用联网搜索。

callback object 可选

可选回调配置；生产环境建议传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务。

url string 必填

接收任务终态通知的 HTTPS 地址。

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

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

标准线路文生视频

不传 route 即走标准线路。

请求体
{
  "model": "seedance-2.0",
  "input": {
    "prompt": "A ceramic cup gently rotating on a clean studio table",
    "aspect_ratio": "16:9",
    "duration": 4,
    "resolution": "480p",
    "generate_audio": false
  }
}
ext 线路 4K 文生视频

顶层 route 填 ext，并使用 ext 支持的 4k 档。

请求体
{
  "model": "seedance-2.0",
  "route": "ext",
  "input": {
    "prompt": "Bioluminescent pearl architecture rising from a midnight ocean, cinematic camera movement",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "4k",
    "generate_audio": true
  }
}
ext 线路参考图

在 ext 线路中使用参考图片。

请求体
{
  "model": "seedance-2.0",
  "route": "ext",
  "input": {
    "prompt": "Animate the reference product with a slow cinematic push-in",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p",
    "reference_image_urls": [
      "https://example.com/reference.jpg"
    ],
    "generate_audio": false
  }
}

获取结果

  1. 读取创建任务响应中的 taskId。
  2. 生产环境优先等待 callback.url 的终态通知。
  3. 也可以使用 GET /v1/tasks/:id 查询任务状态。
  4. 成功后从结果字段读取视频 URL，并将需要长期使用的素材转存到自己的持久存储。

常见问题

如何调用 Seedance 2.0 ext 线路？

model 固定填 seedance-2.0，并在请求体顶层传 route: "ext"。不要把 @ext 写进对外示例。

标准与 ext 有什么区别？

两条线路的分辨率档位、参考素材字段和价格不同。标准线路提供 480p 档并支持参考视频；ext 线路提供 720p、1080p、4k，并支持图片和音频参考。

Seedance 2.0 怎么计费？

按生成视频时长和分辨率档位计费，标准与 ext 的单价不同，具体以实时定价页为准。 查看视频 API 价格

下一步