使用指南
P-Video 2 Pro Replace 上手指南:用 1–2 张照片替换视频里的人
能力、输入要求、API 调用、价格和使用建议
2026年11月12日 3 分钟阅读
- 模型
- p-video-2-pro-replace
本页内容
P-Video 2 Pro Replace 是 Pruna AI 的视频换人模型:给它一段源视频和 1–2 张人物照片,它会保留原视频的动作、镜头、场景和声音,把画面里的人换成照片中的人。这篇文章讲清楚它能做什么、怎么调用、怎么算钱,以及什么时候该换别的模型。
它能做什么
- 一段视频加一张照片就能换人:必填只有源视频
video_url和人物照片image_urls,不需要先训练形象。 - 最多换两个人:
image_urls放 1–2 张照片(jpg、jpeg、png、webp),一个人放一张,两个人时每人各一张。 - 原视频的东西都保留:动作、镜头运动、场景和时长都跟随源视频。
keep_audio默认开启,输出带原视频的声音;设为false时输出不带原音。 - 五档分辨率:480p、768p、1080p、2k、4k,默认 768p,保持源视频的宽高比。
- 可选提示词:
prompt(最多 1000 字符)说明照片里的人怎么放进画面,不写也能生成。
输入要求
- 源视频:MP4、MOV 或 WebM,时长 2–30 秒。超出范围的视频会在提交时被拒绝,不扣费;更长的素材请先剪成 30 秒以内的片段。
- 人物照片:1–2 张,HTTPS 链接。
- 内容安全过滤默认开启,违规内容会失败并返回
CONTENT_POLICY_VIOLATION,费用全额退回。
怎么调用
提交异步任务,拿到 taskId 后轮询结果:
curl https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "p-video-2-pro-replace",
"input": {
"video_url": "https://example.com/source.mp4",
"image_urls": ["https://example.com/person.jpg"],
"resolution": "768p",
"keep_audio": true
}
}'
curl https://api.hiapi.ai/v1/tasks/<taskId> \
-H "Authorization: Bearer $HIAPI_KEY"
任务成功后,output 里是视频地址,时长和源视频一致。
价格
按输出视频时长计费,不足 1 秒的部分不收;放 1 张还是 2 张照片价格一样:
- 480p:$0.0358/秒
- 768p:$0.0715/秒
- 1080p:$0.0858/秒
- 2k:$0.1000/秒
- 4k:$0.1286/秒
例如 10 秒的 768p 视频约 $0.72,30 秒 480p 约 $1.07。提交时先按 30 秒预扣,完成后按实际视频时长结算,多扣的退回。失败的任务全额退回。
怎么用得更好
- 源视频里人物清晰、动作连贯,照片正脸清楚、光线均匀,换出来更稳定。
- 先用 480p 短片段确认效果,再用高分辨率出成片。
- 需要固定结果时传
seed(0–2147483647 的整数),配合相同输入有助于复现。
什么时候选别的
- 想改变画面风格、场景或镜头:这个模型只换人,其余都跟随源视频,请选择视频编辑类模型。
- 没有源视频,只有一张人像和一段台词:用同系列的 P-Video 2 Pro Avatar 生成口播视频。
想直接试效果,可以在 HiAPI Playground 上传一段短视频和一张人物照片生成。
相关文章
查看全部文章 →-
使用指南
通过 hiAPI API 使用 Ideogram V3 Character Edit 编辑电商产品图片
一份开发者指南:一致的主体、干净的背景替换,以及可用的 hiAPI 请求
-
使用指南
通过 HiAPI API 使用 happyhorse-1.1/reference-to-video:提示词配方与短视频工作流
一份开发者指南:如何通过 HiAPI 组织参考图片、编写保持身份一致性的提示词,并为短视频控制节奏
-
使用指南
使用 qwen-image-2.1-pro 生成电商产品图:API 用法与提示词配方
一份端到端的开发者指南:透明 PNG、图像编辑、文字渲染,以及可直接复制的 curl 与 Python requests 提示词