Appearance
视频替换
替换视频中的主体对象
概述
视频替换(replace)用于将视频中的主体替换为指定图片中的对象。
[!NOTE]
- 本平台接口:
POST https://aiapi.fhddos.com/vidu/ent/v2/replace- 官方接口:
POST https://api.vidu.cn/ent/v2/replace,详见 官方 API 文档
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
video_url | string | ✅ | 原视频 URL |
object | string | ✅ | 原视频主体描述(≤ 100 字符) |
image | string | ✅ | 替换主体图片 URL 或 Base64 |
prompt | string | ❌ | 描述要生成的视频内容(≤ 2000 字符) |
start_from | int | ❌ | 从第几秒开始替换 |
payload | string | ❌ | 透传参数 |
callback_url | string | ❌ | 回调地址 |
调用示例
bash
curl -X POST "https://aiapi.fhddos.com/vidu/ent/v2/replace" \
-H "Authorization: Bearer <Fhddos 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
}'计费说明
| 能力 | 计费规则 |
|---|---|
| 视频替换 | 每生成 1 个任务,扣 80 积分 |
返回示例
json
{
"task_id": "your_task_id",
"state": "created",
"duration": 7,
"credits": 80,
"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}
查询结果
任务创建成功后,通过 任务查询 接口获取最终结果。