Seedance 2.5 API

异步生成

查询任务状态,在有效期内保存生成文件。

生成状态

通过 POST /videos 或 POST /images 创建任务。202 表示受理或幂等重放,并不表示文件已生成。使用原密钥查询 GET /generations/{id},处理中至少间隔 10 秒。

Status含义
pending已受理,或仍待确认提交结果。
processing生成中,或正在准备保存文件。
success可获取下载链接。
failed生成失败。
canceled任务已取消。
expired生成文件保留期已结束。

成功响应

{
  "id": "api_0000000000000000000000000000000000000000000000000000000000000000",
  "model": "seedance-2.5-lite",
  "status": "success",
  "created_at": "2026-10-03T12:00:00.000Z",
  "credits": {
    "cost": 80
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://YOUR_SIGNED_OUTPUT_URL",
      "expires_at": "2026-10-03T12:15:00.000Z"
    }
  ],
  "error": null
}

读取 outputs[].url。本 API 没有 output.video_url 或 status_url 字段,使用返回的 id 构造查询路径。签名链接请保密。

下载与保留期

每个链接最多有效 15 分钟,不会超过文件保留期限。保留期内可重新查询获取新链接。生成文件保留 14 天,请在到期前保存到自己的存储。

提交结果未知

网络中断可能发生在受理之后。必须使用原请求体和幂等标识重试。原任务持续 pending 时,保留 ID 并联系支持;不要自动创建替代请求,可能再次扣费。结果未知的任务不会仅因时间过去而自动退款。