ListenHubDocs
API 参考AI 视频

Seedance

Seedance 2.0 与 2.5 的模型、素材限制、Draft 生成和计费说明。

使用 POST /v1/video-generation/generate。2.5 是新增模型,2.0 Pro 和 Fast 继续保留。不传 model 仍默认使用 2.0 Fast。

认证、轮询、任务列表和错误码见 AI 视频总览.

模型限制

ModelRPM
doubao-seedance-2-pro5
doubao-seedance-2-fast5
doubao-seedance-2-55
规则2.0 Pro / Fast2.5
提示词字符数30005000
输出秒数4–154–30 / -1
参考图片930
参考视频3 个;单个 2–15 秒,总计 ≤15 秒10 个;单个 2–30 秒,总计 ≤30 秒;编辑时单个 ≥4 秒
参考音频3 个;必须同时有图片或视频10 个;单个 2–30 秒,总计 ≤30 秒;允许纯音频输入
ResolutionPro: 480p / 720p / 1080p; Fast: 480p / 720p480p / 720p / 1080p; Draft: 480p
宽高比16:9, 4:3, 1:1, 3:4, 9:16, 21:916:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

2.5 默认值:resolution: "720p"、ratio: "adaptive"、duration: 5、omniReferenceTaskType: "auto"、draft: false。

2.5 模式与素材元数据

omniReferenceTaskType 可选 auto(默认)、reference、edit、extend。编辑与延长必须有视频输入并使用 ratio: "adaptive";编辑还必须 duration: -1。首帧、首尾帧也必须使用 adaptive。adaptive 让上游决定输出宽高,-1 让上游决定时长,它们是明确参数值,不是省略字段。多视频编辑请在提示词中指出目标视频。

首帧使用一个 first_frame,可选一个 last_frame。帧角色不能与参考图片、视频、音频混用。参考角色分别为 reference_image、reference_video、reference_audio。

每个素材的元数据放在对应的 image_url、video_url、audio_url 对象中,与 url 同层。每个视频和音频都必须填写自己的 duration(秒)。已知时还应提供真实 width、height、size(字节),视频可提供 fps。一个总时长不能代替逐素材元数据。

图片:边长 300–6000 像素,宽高比 0.4–2.5(包含边界),文件必须小于 30 MiB。视频:边长 300–6000,宽高比 0.4–2.5,像素面积 407,696–8,295,044,24–60 fps,最大 200 MiB。音频最大 15 MiB。视频总时长与音频总时长各自不能超过 30 秒。

2.5 参考生成请求

{
  "model": "doubao-seedance-2-5",
  "content": [
    { "type": "text", "text": "Use Video 1 motion and Audio 1 rhythm" },
    {
      "type": "video_url",
      "role": "reference_video",
      "video_url": {
        "url": "https://example.com/reference.mp4",
        "width": 1280,
        "height": 720,
        "duration": 5,
        "fps": 24,
        "size": 8000000
      }
    },
    {
      "type": "audio_url",
      "role": "reference_audio",
      "audio_url": {
        "url": "https://example.com/reference.wav",
        "duration": 4,
        "size": 800000
      }
    }
  ],
  "omniReferenceTaskType": "reference",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 10,
  "requestId": "reference-request-unique-id"
}

Draft → 正式生成

传 draft: true 与 resolution: "480p" 创建可播放草稿,轮询到 success。在创建后 14 天内,用 ListenHub 返回的 taskId 作为 draftTaskId 创建新的 1080p 正式任务。草稿必须属于当前用户和相同应用/API 身份范围。后端读取原输入和原渠道;正式请求不要重复传内容和其他生成参数。

{
  "model": "doubao-seedance-2-5",
  "draftTaskId": "507f1f77bcf86cd799439011",
  "requestId": "final-request-unique-id"
}

每次主动发起的新生成使用新的 requestId(8–128 个字符),同一次提交的网络重试复用该值,可使用 UUID。任务详情包含可选的 draft、draftTaskId、finalTaskIds;可见生成内容还可能带有 draftEpisodeId、finalEpisodeIds。

预估与结算

草稿和正式生成是两个任务,分别计费。正式生成不会抵扣草稿费用,也不会把草稿输出再次算作参考视频。正式任务失败只退回该任务的预扣费用,已成功草稿继续保留。

调用 POST /v1/video-generation/estimate-credits,提供与生成一致的模型、分辨率、比例、时长、omniReferenceTaskType、draft。referenceImages、referenceVideos、referenceAudios 是元数据数组,每项带 role 和对应文件信息,不带 URL。预估正式任务时只需 model 与 draftTaskId。

视频预估按参考视频总时长、输出时长、输出宽高与 24 fps 计算,并遵循最低 token 规则。各输入视频自己的宽高用于校验,不按各自像素面积分别计费。纯音频使用无视频输入单价,音频秒数不累加到视频秒数。自动参数采用保守预估,完成后按上游实际 token 用量结算,预估值不是保证上限。

2.5 独立使用单价表。相对 2.0 Pro,480p / 720p 的无视频、有视频单价分别上涨 52.86%、48.84%;1080p 分别上涨 51.95%、48.94%。这不意味着每个任务都按同一比例涨价,也不代表固定利润率。

OpenAPI 预估返回 tokens 与 estimatedCostUsd,不返回内部积分。提交时预扣,完成后按实际 token 多退少补。保留任务 ID,重试前先查询已有任务状态。

失败与重试

缺少单个素材时长、混用帧和参考角色、模式与比例或时长不匹配,都会在请求校验时失败。例如 edit 配 duration: 5 不合法,应使用 adaptive 与 -1。

草稿不存在或无权访问时返回 32001;草稿未成功、已过期或不符合条件时返回 32004。例如创建超过 14 天的草稿不能转正式,需要重新创建草稿。

上游审核拒绝或供应商失败通过任务失败状态和现有错误字段返回。5000 字符是产品上限,不保证上游接受。提交超时不等于应该新建任务:先查已有任务,或用相同请求 ID 重试。

本页内容