Pruna AI 出品的极速视频生成模型,同步返回:一次请求阻塞约 30-60 秒,直接拿到视频链接,不用创建任务再轮询。支持 720p / 1080p、1-20 秒、七种画面比例,以及文生视频、图生视频、音画同步三种模式。草稿模式(draft)价格是完整质量的四分之一、出片更快,适合把提示词试顺了再出终版。计价按秒:720p 草稿 $0.01/秒、完整 $0.04/秒,1080p 草稿 $0.02/秒、完整 $0.08/秒。
P-Video 不像 grok / veo / kling 那样走 /api/v1/video/generations,它有自己的专属端点 POST /api/v1/video/p-video,并且是同步的:一次请求阻塞约 30-60 秒后直接返回视频链接,没有 task_id,也没有可轮询的状态。照搬其它视频模型的「创建 + 轮询」代码在这里跑不通。
因此客户端超时要设到 120 秒以上 —— 默认超时较短的 HTTP 客户端会在视频出好之前先自己断掉。
| 档位 | 参数 | 单价 | 5 秒一条 |
|---|---|---|---|
| P-Video 720p Draft | resolution 720p · draft true | $0.01/s | $0.05 |
| P-Video 720p Full | resolution 720p · draft false | $0.04/s | $0.20 |
| P-Video 1080p Draft | resolution 1080p · draft true | $0.02/s | $0.10 |
| P-Video 1080p Full | resolution 1080p · draft false | $0.08/s | $0.40 |
四个档位共用同一个模型串 p-video,靠 resolution 和 draft 两个参数选档,时长 1-20 秒都可以。计费 = 秒数 × 分辨率单价 × 模式(draft 为四分之一价)。
| 模式 | 怎么触发 | 注意 |
|---|---|---|
| 文生视频 | prompt | duration 与 aspect_ratio 都生效 |
| 图生视频 | prompt + image | 传了 image,aspect_ratio 会被上游忽略(画面比例跟参考图走) |
| 音画同步 | prompt + audio | 传了 audio,duration 会被上游忽略,视频长度由音频时长决定 |
音画同步这一条有个容易忽略的账:上游按音频长度出片,但计费仍以你在请求里写的 duration 为准。传一段 12 秒的音频却把 duration 留在默认的 5,拿到的是 12 秒视频、扣的却是 5 秒的钱;反过来写大了就是多付。要账对得上,就把 duration 填成音频的实际时长。
POST /api/v1/video/p-video —— 同步:一次请求返回结果,不需要第二次调用。
# Synchronous endpoint - one request, blocks ~30-60s, returns video URL directly
curl -X POST https://apimodels.app/api/v1/video/p-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A robot dancing in neon-lit Tokyo street, cinematic",
"duration": 5,
"resolution": "720p",
"draft": false,
"aspect_ratio": "16:9"
}'
# Draft mode - 4x cheaper and faster, for iterating on a prompt
curl -X POST https://apimodels.app/api/v1/video/p-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A robot dancing in neon-lit Tokyo street, cinematic",
"duration": 5,
"resolution": "720p",
"draft": true
}'
# Image-to-video: aspect_ratio is ignored upstream when image is provided
curl -X POST https://apimodels.app/api/v1/video/p-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Camera slowly pushes in, hair moving in the wind",
"image": "https://example.com/ref.jpg",
"duration": 5,
"resolution": "1080p"
}'| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| prompt | 是 | string | 视频内容描述文本 |
| duration | 否 | number | 视频时长(秒),1-20,默认 5。提供 audio 时被上游忽略 |
| resolution | 否 | string | "720p"(默认)或 "1080p" |
| draft | 否 | boolean | 草稿模式(4 倍便宜,速度更快)。默认 false |
| aspect_ratio | 否 | string | "16:9"(默认)、"9:16"、"4:3"、"3:4"、"3:2"、"2:3"、"1:1"。提供 image 时被上游忽略 |
| image | 否 | string | 图生视频参考图:URL 或 data: base64(jpg/png/webp) |
| audio | 否 | string | 音频驱动视频(音画同步):URL,支持 flac/mp3/wav |
| last_frame_image | 否 | string | 尾帧参考图:URL |
| fps | 否 | number | 帧率:24(默认)或 48 |
| seed | 否 | number | 随机种子(整数),用于可复现生成 |
| save_audio | 否 | boolean | 是否保留音轨。默认 true |
| prompt_upsampling | 否 | boolean | 启用 prompt 优化。默认 true |
| disable_safety_filter | 否 | boolean | 禁用安全过滤。默认 true(即不过滤 prompt 和输入图) |
成功时 code 为 200,视频链接在 data.url;失败时 code 为对应错误码、原因在 msg。
| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| code | - | number | 200 表示成功 |
| msg | - | string | 成功为 "success",失败时是错误原因 |
| data.url | - | string | 生成好的视频地址 |
| data.credits | - | number | 本次调用扣费($) |
按视频秒数计,四个档位(apimodels.app):720p 草稿 $0.01/秒、完整 $0.04/秒;1080p 草稿 $0.02/秒、完整 $0.08/秒。所以一条 5 秒的片子分别是 $0.05、$0.20、$0.10、$0.40。计费 = 秒数 × 分辨率 × 模式,以请求里写的 duration 为准。
不需要。P-Video 有自己的同步端点 POST /api/v1/video/p-video(apimodels.app):一次请求阻塞约 30-60 秒,直接在 data.url 返回视频地址,没有 task_id 也没有可轮询的状态。其它视频模型那套「创建任务 + 轮询」的代码在这里用不上。客户端超时请设到 120 秒以上。
传 draft: true 就是草稿模式,便宜 4 倍、出片更快 —— 720p 从 $0.04/秒降到 $0.01/秒,1080p 从 $0.08/秒降到 $0.02/秒。提示词、构图、比例还在试的阶段用草稿跑,试顺了再把 draft 改回 false 出终版。其余参数完全一样,换档只改这一个字段。
支持,同一个端点上有三种模式。文生视频只需要 prompt;图生视频再传 image(URL 或 data: base64,支持 jpg/png/webp),传了 image 时 aspect_ratio 会被上游忽略;音画同步再传 audio(flac/mp3/wav 的 URL),传了 audio 时 duration 会被上游忽略、成片长度跟着音频走 —— 但扣费仍按你请求里写的 duration 计算,所以把 duration 填成音频的实际时长才对得上账。另外还可以传 last_frame_image 作为尾帧参考。
分辨率 720p 或 1080p,时长 1-20 秒(默认 5 秒),七种画面比例:16:9(默认)、9:16、4:3、3:4、3:2、2:3、1:1,帧率 24 或 48。还可以传整数 seed 做可复现生成,用 save_audio 决定是否保留音轨,用 prompt_upsampling 开关提示词优化。结果文件保留 7 天,需要长期保存请及时下载或转存。