Skip to main content

​
概述

视频替换（replace）用于将视频中的主体替换为指定图片中的对象。
[!NOTE]
  • 本平台接口：POST https://models.kapon.cloud/vidu/ent/v2/replace
  • 官方接口：POST https://api.vidu.cn/ent/v2/replace，详见 官方 API 文档

​
请求参数

参数类型必填说明
video_urlstring✅原视频 URL
objectstring✅原视频主体描述（≤ 100 字符）
imagestring✅替换主体图片 URL 或 Base64
promptstring❌描述要生成的视频内容（≤ 2000 字符）
start_fromint❌从第几秒开始替换
payloadstring❌透传参数
callback_urlstring❌回调地址

​
调用示例

curl -X POST "https://models.kapon.cloud/vidu/ent/v2/replace" \
  -H "Authorization: Bearer <kapon Token>" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://your.cdn.com/original.mp4",
    "object": "蓝色裙子",
    "image": "https://your.cdn.com/subject.png",
    "prompt": "一个女人穿着橙色的小裙子在跳舞",
    "start_from": 3
  }'

​
返回示例

{
  "task_id": "your_task_id",
  "state": "created",
  "duration": 7,
  "credits": 6,
  "created_at": "2025-01-01T06:48:29.368Z"
}

​
素材要求

​
视频要求

  • 时长：2–10 秒
  • 清晰度：480p–1080p

​
图片要求

  • 格式：png / jpeg / jpg / webp
  • 数量：仅 1 张
  • 比例：小于 1:4 或 4:1
  • 大小：≤ 50MB
  • 清晰度：360p–1080p
  • Base64 格式需包含前缀：data:image/png;base64,{base64_encode}

​
查询结果

任务创建成功后，通过 任务查询 接口获取最终结果。