apimodels.app

P-Video API(Pruna AI)—— 同步返回的极速视频生成

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://api.apimodels.app/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 more affordable and faster, for iterating on a prompt
curl -X POST https://api.apimodels.app/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://api.apimodels.app/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	本次调用扣费($)

计费与限制

计费 = 秒数 × 分辨率 × 模式(draft 为四分之一价),以请求参数里的 duration 为准。
时长范围 1-20 秒,不传默认 5 秒。
先用 draft 把提示词、构图、比例试顺,再关掉 draft 出终版 —— 同样的 5 秒 720p,草稿 $0.05、完整 $0.20。
单次请求阻塞约 30-60 秒,客户端超时建议设为 120 秒以上。
disable_safety_filter 默认就是 true,也就是默认不对 prompt 和输入图做过滤 —— 需要过滤请显式传 false。
结果文件保留 30 天,请及时下载或转存。

常见问题

P-Video API 多少钱?

按视频秒数计,四个档位(apimodels.app):720p 草稿 $0.01/秒、完整 $0.04/秒;1080p 草稿 $0.02/秒、完整 $0.08/秒。所以一条 5 秒的片子分别是 $0.05、$0.20、$0.10、$0.40。计费 = 秒数 × 分辨率 × 模式,以请求里写的 duration 为准。

调 P-Video 需要轮询吗?

不需要。P-Video 有自己的同步端点 POST /api/v1/video/p-video(apimodels.app):一次请求阻塞约 30-60 秒,直接在 data.url 返回视频地址,没有 task_id 也没有可轮询的状态。其它视频模型那套「创建任务 + 轮询」的代码在这里用不上。客户端超时请设到 120 秒以上。

P-Video 的草稿模式(draft)是什么,什么时候用?

传 draft: true 就是草稿模式,便宜 4 倍、出片更快 —— 720p 从 $0.04/秒降到 $0.01/秒,1080p 从 $0.08/秒降到 $0.02/秒。提示词、构图、比例还在试的阶段用草稿跑,试顺了再把 draft 改回 false 出终版。其余参数完全一样,换档只改这一个字段。

P-Video 支持图生视频和音频驱动吗?

支持,同一个端点上有三种模式。文生视频只需要 prompt;图生视频再传 image(URL 或 data: base64,支持 jpg/png/webp),传了 image 时 aspect_ratio 会被上游忽略;音画同步再传 audio(flac/mp3/wav 的 URL),传了 audio 时 duration 会被上游忽略、成片长度跟着音频走 —— 但扣费仍按你请求里写的 duration 计算,所以把 duration 填成音频的实际时长才对得上账。另外还可以传 last_frame_image 作为尾帧参考。

P-Video 支持哪些分辨率、时长和帧率?

分辨率 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 开关提示词优化。结果文件保留 30 天,需要长期保存请及时下载或转存。

本页涉及的模型

P-Video · $0.05+