视频编辑V3

请求体

模型参数

音频处理取决于所选模型和编辑指令，不保证原声原样保留；本接口不提供独立声音开关或参考音频输入，请勿传入 voice 或 audio。

时长规则

跟随原视频时长

videoTime=-1 表示输出时长跟随原视频。以下模型只支持该模式：

• kling-v3-omni
• LF_OM_1_1_FLASH
• happyhorse-v2
• doubao-seedance-2-5

happy-horse-v2 是兼容别名，新接入请使用 happyhorse-v2。

• 系统会读取原视频的真实时长；视频无法访问或无法识别时长时，任务不会创建。
• 上述模型不要传 5、10、15 等固定时长，否则会返回参数错误。

固定时长可选

• doubao-seedance-2-0 和 WAN3 支持 5 / 10 / 15 秒。
• 不传 videoTime 时使用当前模型默认时长；这两类模型不支持 -1。

原视频时长限制

• 固定输出时长不等于原视频时长上限；可处理的原视频长度以模型实际能力为准。
• 建议使用稳定可访问的 HTTPS 视频地址，并控制原视频长度，避免任务在生成阶段失败。

素材尺寸与排错

参考图片尺寸

参考图预检按 useAssetWhitelist 和实际素材路径分流，详见上方Seedance 素材加白。需要入库时按素材库图片限制检查；直接使用 URL 时按当前模型限制检查。尺寸不符合要求时返回 ERR_VIDEO_IMAGE_DIMENSION_INVALID，API 不自动缩图。

前端参考图上传规格

• 格式：JPG/JPEG/PNG/WEBP。
• 宽和高均为 300～4096 像素（含边界），宽高比（宽÷高）为 0.4～2.5（含边界）。
• 目标大小不超过 10MB；超过边长或体积限制时，可按页面提示确认压缩后上传。

API 直接传图片 URL 不经过前端压缩；后续是否上传素材库由加白开关及所选模型决定。入库按素材库限制预检，直传模型按模型限制预检。

尺寸错误处理

例如第 2 张参考图为 5923×7898，其高度超过素材库入库上限；应提示“第 2 张参考图片尺寸超限，实际为 5923×7898，高度须在 300～6000 像素之间”。可等比缩小到约 2250×3000，重新上传后再提交。

参考图片尺寸错误可在资产入库阶段触发，尚未进入视频生成。将原视频转为 H.264 无法修复图片高度超限；请调整报错对应的参考图片。

请求示例

Seedance 2.5，跟随原视频时长

{
  "sourceVideoUrl": "https://example.com/source.mp4",
  "prompt": "保持人物动作和镜头节奏不变，将背景替换为海滩",
  "videoType": "doubao-seedance-2-5",
  "refImageList": [
    "https://example.com/reference.png"
  ]
}

WAN3，固定 10 秒

{
  "sourceVideoUrl": "https://example.com/source.mp4",
  "prompt": "保留商品主体，将场景调整为明亮的现代客厅",
  "videoType": "WAN3",
  "videoTime": 10,
  "refImageList": [
    "https://example.com/product-main.jpg",
    "https://example.com/product-detail.jpg"
  ]
}

可灵 V3-Omni，跟随原视频时长

{
  "sourceVideoUrl": "https://example.com/source.mp4",
  "prompt": "保持主体和构图不变，将整体风格调整为电影质感",
  "videoType": "kling-v3-omni",
  "videoTime": -1
}

Seedance 2.0，不传时长使用模型默认固定时长

{
  "sourceVideoUrl": "https://example.com/source.mp4",
  "prompt": "保持人物身份和动作一致，将服装颜色改为深蓝色",
  "videoType": "doubao-seedance-2-0"
}

提交后返回什么

提交成功后返回任务编号 data.id，表示任务已创建，结果还需等待生成。请保存编号。查看返回示例。

查询生成结果

用任务编号 data.id 调用获取作图结果，每次查询至少间隔 10 秒。data.status=3 表示成功；若生成了图片或视频，从 data.resultList[].url 获取地址。data.status=4 表示失败。查看统一示例。

常见问题

• 模型不可用：确认 videoType 使用上表中的公开名称，并确认当前账号可使用该模型。
• 视频时长报错：LF_OM_1_1_FLASH、Seedance 2.5、可灵 V3-Omni、HappyHorse 仅允许 -1 或不传；Seedance 2.0、WAN3 仅允许模型支持的固定时长，不支持 -1。
• 未传时长后结果与预期不符：跟随原视频模型（包括可灵 V3-Omni）会自动按 -1 处理；Seedance 2.0、WAN3 则取模型默认时长，未配置时回退 5 秒。
• 跟随原视频模型无法创建：确认 sourceVideoUrl 可由服务端访问并能正确解析媒体时长；不要为这类模型传固定 videoTime。
• 无法读取原视频时长：确认 URL 可公网访问、未过期，且返回的是可解析的视频内容。
• 参考图片数量超限：数量上限按模型配置校验，具体见模型对照表；当前 Seedance 2.5 可传 30 张。
• 任务失败或长时间无结果：检查视频、图片地址是否持续可访问，提示词是否合规，以及账户算力是否充足；素材超过模型支持范围也可能导致任务失败。

扣费标准

扣点数 = 单价（点/秒）× 计费时长（秒）。固定时长模型按 videoTime 计费；跟随原视频的模型按原视频实际时长向下取整计费。输出分辨率和比例由所选模型及原视频决定，参考图不额外增加扣点。