使用指南
P-Video 2 Pro Avatar 上手指南:一张人像加音频或文字稿,生成最长 3 分钟的口播视频
能力、输入规则、API 调用、价格和提示词写法
- 模型
- p-video-2-pro-avatar
本页内容
P-Video 2 Pro Avatar 是 Pruna AI 的口播视频模型:给它一张人像,再给一段音频或一段文字稿,它会生成这个人开口说话的视频。这篇文章讲清楚它能做什么、怎么调用、怎么算钱,以及什么时候该换别的模型。
它能做什么
- 一张人像就能出镜:必填只有人像图
image_url(jpg、jpeg、png、webp),它是视频的第一帧,不需要视频素材,也不需要先训练形象。 - 两种驱动方式:传音频
audio_url时,视频长度等于音频长度;只传文字稿script(最多 5000 字符)时,用内置语音朗读。单条最长 3 分钟,4k 下音频最长 125 秒。 - 内置语音可选:30 种声音(名称里标了性别,默认 Zephyr (Female)),10 种语言:美式英语、英式英语、西班牙语、法语、德语、意大利语、巴西葡萄牙语、日语、韩语、印地语,暂不含中文。
voice_prompt写语气、语速和情绪,这段文字不会被读出来。 - 提示词控制画面:
prompt(最多 2000 字符)描述人物说话时的样子、动作和神态,默认是 “The person is talking.”。 - 五档分辨率:480p、768p、1080p、2k、4k,默认 768p。
输入规则
- 音频和文字稿至少给一个。两个都给时以音频为准,
script、voice、voice_language、voice_prompt都不生效。 - 两个都不给,任务会失败,提示补上其中一个,费用全额退回。
- 内容安全过滤默认开启,违规内容会失败并返回
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-avatar",
"input": {
"image_url": "https://example.com/portrait.png",
"script": "Welcome to the course. Today we cover three ideas.",
"voice": "Charon (Male)",
"voice_language": "English (US)",
"voice_prompt": "Calm and clear, moderate pace",
"resolution": "768p"
}
}'
curl https://api.hiapi.ai/v1/tasks/<taskId> \
-H "Authorization: Bearer $HIAPI_KEY"
用自己的录音时,把 script 和几个 voice 参数换成 "audio_url": "https://example.com/voice.mp3" 即可。任务成功后,output 里是视频地址。
价格
按输出视频时长计费,不足 1 秒的部分不收:
- 480p:$0.0286/秒
- 768p:$0.0572/秒
- 1080p:$0.0858/秒
- 2k:$0.1143/秒
- 4k:$0.1715/秒
例如 30 秒的 768p 口播约 $1.72,30 秒 480p 约 $0.86。传音频时按音频时长预扣;只传文字稿时,提交时还不知道朗读多长,会先按 3 分钟预扣,完成后按实际视频时长结算,多扣的退回。失败的任务全额退回。
提示词怎么写
prompt 只写画面,不写台词。按「人物外观 → 动作幅度 → 表情和视线 → 光线或镜头」的顺序写,例如:
- 课程讲解:
A calm instructor in a dark shirt, small head nods, steady eye contact, soft studio light - 展馆导览:
A curator speaking warmly to camera, blinks naturally, warm gallery lighting
语气和节奏写在 voice_prompt 里,例如 “Speak softly, small pauses between sentences”。
什么时候选别的
- 要把已有视频里人物的口型改成新音频,或者要做没有人说话的图生视频:这不是 P-Video 2 Pro Avatar 的用途,请选对应的视频编辑或图生视频模型。
- 要把视频里的人换成另一个人、保留原视频的动作和镜头:用同系列的 P-Video 2 Pro Replace。
想直接试效果,可以在 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 提示词