结合 Comfy Router 使用 P Video 2

通过 Comfy Router 调用 pruna/p-video-2:介绍端点、请求结构以及 Router 返回的响应。

pruna/p-video-2 的 API 参考文档，由 Pruna 通过 Comfy Router 提供。

输入： 文本, 图像, 音频 · 输出： 视频 + 音频

快速开始

在你的 Comfy 工作区中创建一个密钥，并将其导出为 COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK（pip install comfy-sdk 和 npm install @comfyorg/sdk）；cURL 代码片段则是通过原始 HTTP 发送的同一调用。

模型 ID： pruna/p-video-2

端点： POST https://api.comfy.org/v2/models/pruna/p-video-2

[tab] 等待结果 ``python Python theme={null} from comfy_sdk import Comfy # 从环境变量中读取 COMFY_API_KEY。 # SDK 会自动创建幂等键，并在自动重试时复用它。 with Comfy() as client: result = client.models.run( "pruna/p-video-2", { "input": { "aspect_ratio": "16:9", "draft": False, "duration": 2, "fps": 24, "prompt": "A single red maple leaf resting on a plain white background.", "resolution": "720p", }, }, ) print(result) ` `typescript TypeScript theme={null} import { comfy } from "@comfyorg/sdk"; // 从环境变量中读取 COMFY_API_KEY。 // SDK 会自动创建幂等键，并在自动重试时复用它。 const { data } = await comfy.models.run("pruna/p-video-2", { input: { aspect_ratio: "16:9", draft: false, duration: 2, fps: 24, prompt: "A single red maple leaf resting on a plain white background.", resolution: "720p", }, }); console.log(data); ` `bash cURL theme={null} curl https://api.comfy.org/v2/models/pruna/p-video-2 \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d "{\"input\": {\"aspect_ratio\":\"16:9\",\"draft\":false,\"duration\":2,\"fps\":24,\"prompt\":\"A single red maple leaf resting on a plain white background.\",\"resolution\":\"720p\"}}" ``

[tab] 排队并稍后收集将相同的请求体发送到 POST https://api.comfy.org/v2/models/pruna/p-video-2/requests。运行被受理后，Router 会立即返回 201 和 request_id；结果就绪后，可以从本进程或其他进程收集。队列投递会详细讲解状态、取消与收集。 ``python Python theme={null} import asyncio from comfy_sdk import AsyncComfy # 从环境变量中读取 COMFY_API_KEY。 # 每次 submit() 调用都会生成自己的 Idempotency-Key，并在自动重试时复用它。 async def main(): async with AsyncComfy() as client: handle = await client.models.submit( "pruna/p-video-2", { "input": { "aspect_ratio": "16:9", "draft": False, "duration": 2, "fps": 24, "prompt": "A single red maple leaf resting on a plain white background.", "resolution": "720p", }, }, ) print("request_id:", handle.request_id) # 连同模型 ID，就是另一个进程所需的全部信息 # 轮询直到请求完成，按服务器给出的 Retry-After 等待。 async for update in handle.iter_events(): print(update.status, update.queue_position) # 提供商自己的载荷，与 models.run() 返回的值相同。 # 失败或已取消的请求会在此处抛出带类型的 Router 错误。 result = await handle.get() print(result) asyncio.run(main()) ` `typescript TypeScript theme={null} import { comfy } from "@comfyorg/sdk"; // 从环境变量中读取 COMFY_API_KEY。 // 每次 submit() 调用都会生成自己的 Idempotency-Key，并在自动重试时复用它。 const handle = await comfy.models.submit("pruna/p-video-2", { input: { aspect_ratio: "16:9", draft: false, duration: 2, fps: 24, prompt: "A single red maple leaf resting on a plain white background.", resolution: "720p", }, }); console.log("requestId:", handle.requestId); // 连同模型 ID，就是另一个进程所需的全部信息 // 轮询直到请求完成，按服务器给出的 Retry-After 等待。 for await (const update of handle.events()) { console.log(update.status, update.queuePosition); } // 与 models.run() 返回的结果相同。失败或已取消的请求会在此处 reject。 const result = await handle.get(); console.log(result.data); ` `bash cURL theme={null} # 1. 提交。Router 返回 201，并带有 request_id、status_url、response_url 和 cancel_url。 curl https://api.comfy.org/v2/models/pruna/p-video-2/requests \ -H "X-API-Key: $COMFY_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d "{\"input\": {\"aspect_ratio\":\"16:9\",\"draft\":false,\"duration\":2,\"fps\":24,\"prompt\":\"A single red maple leaf resting on a plain white background.\",\"resolution\":\"720p\"}}" # 2. 轮询直到状态为 COMPLETED，按每个响应给出的 Retry-After 秒数等待。 REQUEST_ID="<request_id from the 201 body>" curl -i https://api.comfy.org/v2/models/pruna/p-video-2/requests/$REQUEST_ID/status \ -H "X-API-Key: $COMFY_API_KEY" # 3. 收集。返回 200 和模型的原生输出；仍在运行时返回 202 和状态响应体。 curl https://api.comfy.org/v2/models/pruna/p-video-2/requests/$REQUEST_ID \ -H "X-API-Key: $COMFY_API_KEY" ``

Schema

输入

input object required

P-Video-2 生成参数。生成按已完成视频的秒数计费，以返回的文件为准，费率由 resolution 和 draft 决定。安全过滤始终开启；请求中的 disable_safety_filter 值会被忽略。

input.aspect\_ratio string (default: "16:9")

宽高比：16:9、9:16、4:3、3:4、3:2、2:3 或 1:1。当设置了 image 时忽略。

input.audio string

用于条件化生成的输入音频 URI（flac、mp3 或 wav）。输出时长跟随音频。

input.draft boolean (default: false)

更快、质量更低的预览，按 draft 费率计费。

input.duration integer

所生成视频的时长，单位为秒（1-20）。省略时，模型会根据提示词选择长度，最长 20 秒。当设置了 audio 时忽略。

范围：1 到 20

input.fps integer (default: 24)

帧率：24 或 48。

input.image string

用于图生视频的输入图像 URI（jpg、jpeg、png 或 webp）。

input.last\_frame\_image string

最后一帧的参考图像 URI。

input.prompt string required

用于视频生成的文本提示词。

input.prompt\_upsampling boolean (default: true)

在生成之前重写提示词。当需要通过 seed 复现结果时，请将其禁用。

input.resolution string (default: "720p")

输出分辨率：720p 或 1080p。

input.save\_audio boolean (default: true)

保存带音频的视频。

input.seed integer

用于可复现生成的随机种子。省略时随机。

由 Router 在 GET /v2/models/pruna/p-video-2/openapi.json 提供的 schema 生成，这也是请求到达提供商之前 Router 用于校验调用的同一份文档。

输出

error string

报错信息。当状态为 failed 时存在。

generation\_url string

已完成视频的 URL。当状态为 succeeded 时存在。

message string

人类可读的进度信息。

status string

预测状态：starting、processing、succeeded、failed 或 canceled。

示例

输入

{
  "input": {
    "aspect_ratio": "16:9",
    "draft": false,
    "duration": 2,
    "fps": 24,
    "prompt": "A single red maple leaf resting on a plain white background.",
    "resolution": "720p"
  }
}

输出

{
  "generation_url": "https://example.invalid/pruna/p-video-2/output.mp4",
  "status": "succeeded"
}

发布前须知

SDK 会生成 Idempotency-Key 并在自动重试中复用它。手动重试时，请复用原始 key。Router 最长可保持连接 10 分钟。

请求失败时，Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入，413 表示请求体超出了 Router 可接受的大小。已生成的资源请及时下载，因为结果 URL 会过期。

上文任何字段描述中提到的尺寸限制，都是提供商对该字段自身的限定，引自提供商的规范。Router 会对整个请求体另行设置上限，base64 编码的媒体内容也计入其中：参见请求体大小。

本页记录的是通过 Comfy Router 调用的某一个合作伙伴模型。同一个 comfy-sdk / @comfyorg/sdk 包还提供第二个客户端，用于在 Comfy Cloud 上运行完整的 ComfyUI 工作流图：Comfy(api_key=...) / new Comfy({ apiKey })，并带有 client.workflows、client.assets 和 client.jobs。请参阅 Comfy SDKs。

[card] 请求头身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。

[card] 使用 Router API 模型发现、验证错误、重试与计费。

[card] 限制 Router 目前不支持的功能，以及替代方案。