如何使用 Pruna P-Video 2 Pro 数字人 API:图生视频接入指南(2026)
Pruna P-Video 2 Pro 数字人 API 接入教程:参数说明、价格与可直接运行的调用代码,先在 Playground 试玩再一行代码接入。
Pruna P-Video 2 Pro 数字人 是一款图生视频模型(由 Pruna Ai 提供):用人像图片和语音生成最长 180 秒的数字人视频。在 NamiFusion 上可以在 Playground 直接试玩(提交前显示准确报价),再通过统一 REST API 一行代码接入,典型一次调用约 $0.040。
TL;DR
· 任务类型:图生视频,由 Pruna Ai 提供
· 价格:典型一次调用约 $0.040($1 = 100 积分),按量计费无订阅
· 上手路径:Playground 试玩(提交前显示报价)→ API Keys 建密钥 → 一个 POST 接入
· 可调参数:5 个(见下方参数表)
· 无平台水印,商用可用(遵守服务条款)
用 Pruna P-Video 2 Pro 数字人 能做什么?
短视频与广告片段:从一句话或一张图直接产出可发布的动态素材。
产品演示与概念预览:低成本验证分镜和视觉方向,再决定是否实拍。
社媒内容工厂:批量生成竖屏短片,配合热点话题快速上线。
已有素材的二次创作:图生视频让静态作品动起来,延长内容生命周期。
怎么调用这个 API?
- 在 NamiFusion 注册并在 API Keys 页面创建密钥(注册赠送积分仅可用于指定模型)。
- 用下面的 cURL 示例提交任务,Header 带上 Bearer 密钥。
- 用返回的 task_uuid 轮询任务状态,完成后取输出 URL。
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/pruna-ai/p-video-2-pro/avatar" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"image": "https://example.com/input.jpg",
"resolution": "768p",
"prompt_upsampling": false
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"有哪些参数?
image(图片):必填
prompt(提示词):可选
resolution(分辨率):可选,默认 "768p"
prompt_upsampling(提示词增强):可选,默认 false
seed(随机种子):可选
Pruna P-Video 2 Pro 数字人 的提示词怎么写?
- 主体在前:先写画面主角与动作,再补环境、光线、风格("一名宇航员在雨中的霓虹街头奔跑,电影感,浅景深")。
- 用具体名词代替形容词堆砌:"85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
- 迭代时只改一个变量:固定 seed 复现结果,每次只调整一个描述词,才能知道是什么在起作用。
- 负面信息放正面写:与其说"不要模糊",不如直接要"锐利对焦、清晰细节"。
价格是多少?
按次积分计价,典型一次调用约 $0.040($1 = 100 积分),实际价格随参数(分辨率/时长等)变化,Playground 里提交前会显示准确报价。
Pruna P-Video 2 Pro 数字人
用人像图片和语音生成最长 180 秒的数字人视频。
输入参数
| Parameter | 必填 | 类型、可选值、默认值 |
|---|---|---|
image | 必填 | array; max count: 1. 用于生成说话视频的人像图片。 |
audio | 必填 | string. 语音音频。输出时长将跟随此输入,最长 180 秒。 |
prompt | 可选 | string; max 5000 characters. 可选,用于指定人物动作和画面构图。 |
resolution | 可选 | string; 480p / 768p; default: "768p". |
prompt_upsampling | 可选 | boolean; default: false. 自动增强动作和表情提示词。 |
seed | 可选 | integer; step: 1. |
Nami 按当前 MaaS 接口约束接收最多 5000 字符的提示词;必填提示词不能为空。
Nami 的 image、last_image 接收单元素 URL 数组,转发上游时转换为单个 URL。不使用尾帧时省略 last_image。
提供人像图片(JPG/JPEG/PNG/WebP,最大 20 MiB)和 1–180 秒语音(最大 64 MiB)。prompt 可省略,省略时由上游使用默认说话指令;本接口没有 duration 或 mode 参数。
标准价
1 美元 = 100 积分,账户折扣另算。
计费秒数 = min(max(ceil(输入音频秒数), 1), 180)。480p 每计费秒 $0.02(2 积分),768p 每计费秒 $0.04(4 积分);输出时长跟随音频。prompt、prompt_upsampling 和 seed 不加费。
接口调用
请使用可访问的素材 URL。仅提交一次,再用 task_uuid 查询至 completed 或 failed;成功结果 output.videos 为视频 URL 数组。
POST https://www.namifusion.com/api/v1/marketplace/run/pruna-ai/p-video-2-pro/avatar
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
Content-Type: application/json
{
"input": {
"resolution": "768p",
"image": [
"https://example.com/portrait.png"
],
"audio": "https://example.com/speech.mp3",
"prompt_upsampling": false
}
}
GET https://www.namifusion.com/api/v1/marketplace/run/tasks/{task_uuid}
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
常见问题
可以先免费试用吗?+
注册赠送积分仅可用于指定模型,适用范围会持续更新;Playground 提交前会显示准确报价。
生成内容可以商用吗?有水印吗?+
可以商用,NamiFusion 不给生成结果加平台水印;使用须遵守服务条款与适用法律。
内容政策是什么?+
色情内容、涉及未成年人的性化内容、未经授权使用真人、欺骗性冒充、诈骗与虚假代言均禁止。合法、自愿且非露骨的成年人主题可能被允许,详见服务条款。
Pruna P-Video 2 Pro 数字人 的任务要跑多久?+
取决于参数,图像通常数秒到数十秒,视频通常数十秒到几分钟;API 返回 task_uuid 供轮询。
分辨率/时长上限是多少?+
以模型参数表为准:每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。