如何使用 Pruna P-Video 2 Pro 文生视频 API：文生视频接入指南（2026）
Pruna P-Video 2 Pro 文生视频 API 接入教程：参数说明、价格与可直接运行的调用代码，先在 Playground 试玩再一行代码接入。
Pruna P-Video 2 Pro 文生视频 是一款文生视频模型（由 Pruna Ai 提供）：生成带音频的 5–15 秒视频，支持 480p、768p 和 cost、speed、quality 模式。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.175。
TL;DR
· 任务类型：文生视频，由 Pruna Ai 提供
· 价格：典型一次调用约 $0.175（$1 = 100 积分），按量计费无订阅
· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入
· 可调参数：7 个（见下方参数表）
· 无平台水印，商用可用（遵守服务条款）
用 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/text-to-video" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "768p",
"mode": "speed",
"prompt_upsampler": "turbo"
}
}'
# 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"有哪些参数？
prompt（提示词）：必填
duration（时长）：可选，默认 5
aspect_ratio（宽高比）：可选，默认 "16:9"
resolution（分辨率）：可选，默认 "768p"
mode（模式）：可选，默认 "speed"
prompt_upsampler（提示词增强）：可选，默认 "turbo"
seed（随机种子）：可选
Pruna P-Video 2 Pro 文生视频 的提示词怎么写？
- 主体在前：先写画面主角与动作，再补环境、光线、风格（"一名宇航员在雨中的霓虹街头奔跑，电影感，浅景深"）。
- 用具体名词代替形容词堆砌："85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
- 迭代时只改一个变量：固定 seed 复现结果，每次只调整一个描述词，才能知道是什么在起作用。
- 负面信息放正面写：与其说"不要模糊"，不如直接要"锐利对焦、清晰细节"。
价格是多少？
按次积分计价，典型一次调用约 $0.175（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。
Pruna P-Video 2 Pro 文生视频
生成带音频的 5–15 秒视频，支持 480p、768p 和 cost、speed、quality 模式。
输入参数
| Parameter | 必填 | 类型、可选值、默认值 |
|---|---|---|
prompt | 必填 | string; max 5000 characters. 用于描述要生成视频的文本提示词。 |
duration | 可选 | integer; min: 5.0; max: 15.0; step: 1.0; default: 5. 视频时长（秒），范围为 5 到 15。 |
aspect_ratio | 可选 | string; 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 1:1; default: "16:9". 生成视频的宽高比。 |
resolution | 可选 | string; 480p / 768p; default: "768p". 输出视频分辨率。 |
mode | 可选 | string; speed / quality / cost; default: "speed". 生成模式：cost 表示以更低成本生成，输出质量与 speed 相同；speed 表示更快生成；quality 表示更高质量生成。默认值：speed。与 prompt_upsampler 独立。 |
prompt_upsampler | 可选 | string; off / turbo / max; default: "turbo". 提示词扩展模式。与 cost、speed 或 quality 生成模式相互独立；不会改变价格。 |
seed | 可选 | integer; step: 1. 可选的随机种子，用于复现生成结果。不填则使用随机种子。 |
Nami 按当前 MaaS 接口约束接收最多 5000 字符的提示词；必填提示词不能为空。
标准价
1 美元 = 100 积分，账户折扣另算。
费用 = 请求的输出秒数 × 分辨率及生成模式的秒价。时长为 5–15 整秒，默认 5 秒。生成音频和 prompt_upsampler 不另收费；mode 默认 speed，prompt_upsampler 默认 turbo。
| Resolution | cost (USD/s) | speed (USD/s) | quality (USD/s) |
|---|---|---|---|
| 480p | $0.01 | $0.02 | $0.04 |
| 768p | $0.025 | $0.035 | $0.075 |
接口调用
请使用可访问的素材 URL。仅提交一次，再用 task_uuid 查询至 completed 或 failed；成功结果 output.videos 为视频 URL 数组。
POST https://www.namifusion.com/api/v1/marketplace/run/pruna-ai/p-video-2-pro/text-to-video
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
Content-Type: application/json
{
"input": {
"resolution": "768p",
"prompt": "A colorful scene with gentle natural movement.",
"duration": 5,
"aspect_ratio": "16:9",
"mode": "speed",
"prompt_upsampler": "turbo"
}
}
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 中列出。