共享生成策略

在任何付费的 POST /v1/predictions 请求之前：

1. 随机种子仪式 — 始终为第一步；通过求和取模（sum-mod）推导各维度轴。
2. 生成多样性 — 使用显式提示词；每会话至少轮换 ≥2 个场景维度轴。
3. 质量检查清单 — 打开输出文件并人工判定通过/失败，再继续后续流程。

p-video-animate（Pruna）

P-Video-Animate 利用给定视频中的运动、节奏与摄像机运镜，对单张图像进行动画化处理。

该能力所解答的用户问题： 如何为这张图片添加动态效果？

给定一张参考图像与一段参考视频，模型将生成一段新视频，其具备：(1) 参考图像的视觉风格，以及 (2) 完整保留参考视频原有的运动、表演、时间节奏、摄像机运动与场景结构。

亦可在 Replicate 上使用：prunaai/p-video-animate。完整 P-API 参数说明见：p-video-animate 模型文档 · 运行指南（Runware 托管版）：从视频生成图像动画

共享 HTTP 模式文档：pruna-api.md

p-video-animate 与 p-video-replace 对比

请选择 p-video-replace 实现真实视频片段中的原位身份替换。请选择本能力 实现运动迁移演示、角色变体生成、滑块式前后对比展示等场景。

核心特性

• 顶级视觉质量
• 最高推理效率
  • 速度：每生成 1 秒视频耗时 5.24 秒
  • 价格：720p 视频每秒 $0.03，1080p 视频每秒 $0.06

典型应用场景

• UGC 广告变体 — 大规模复用已验证有效的视频运动模板，搭配不同创作者、客户或角色形象。
• 病毒式模因混剪 — 快速将热门短视频转化为基于图像的新形态动画模因。
• 电影场景重演 — 使用可复用的运动模板，为用户上传的头像、自拍或角色图像生成动画。
• 游戏过场动画变体 — 使用可复用的运动模板，为用户上传的头像、自拍或角色图像生成动画。

生成前准备

1. 生成多样性 — 执行种子仪式 + 维度轴轮换；若已设定，则以 seed 字段传入。
2. 需向用户确认以下输入项：

• video URL — 运动/音频源（请先将 .mp4 文件上传至 /v1/files）
• image URL — 待动画化的主体图像（请先上传 jpg/jpeg/png/webp 格式）
• resolution：可选 720p 或 1080p
• target_fps：可选 original、24 或 48
• 可选 instruction_prompt — 描述参考主体应如何遵循源视频运动
• 可选 save_audio、seed、disable_safety_checker

请对输入与输出运行 p-video-animate-quality-checklist.md。

批量运行： 当多个图像+视频组合相互独立时，请一次性创建全部预测任务，并行异步提交，随后统一轮询结果。详见 parallel-execution.md。

实现高质量运动迁移的关键

外观来自图像，运动来自视频。 影响最终质量的最大因素是参考图像与源视频首帧的匹配程度。每次配对前请务必核查：

1. 构图 — 是否为相同身体区域（如肩部以上、中景、全身）？
2. 姿态 — 主体朝向与肢体位置是否大致对齐？
3. 可见性 — 是否呈现相同的身体部位？是否存在源视频中没有的额外裁剪或遮挡？

当上述三项完全一致时，运动迁移效果最佳——包括次要线索（如摄像机漂移、发丝摆动、阴影变化）均可准确复现；不匹配的配对则会丢失这些细节。

配对失败时的表现： 肩部以上静帧 + 全身舞蹈动作 → 模型不会幻化出缺失肢体；仅头部轻微漂移，且绝大多数编舞动作丢失。此时请生成全身参考图，或选用更接近的模板。

生成前优化： 若构图或姿态接近但不精确，可用 p-image-edit 进行重构图；对参考静帧执行超分以增强身份细节。

长视频处理： 计算开销约为每秒视频约 5 秒计算时间 —— 对于长模板，请拆分源视频并分段单独动画化。

错误工具选择： 本能力不适用于物体移除、背景替换、场景重写或逐帧像素级编辑 —— 此类需求请改用 p-image-edit、p-video-replace 或补全（inpainting）工作流。

instruction_prompt — 可选字段；用于覆盖行为表现，而非屏幕上显示的对象身份。若源视频运动本身已符合预期，请留空。

有效示例（在源运动基础上叠加一个明确节拍）：

在视频结尾处，她完成最后一个手势后，面向镜头清晰地竖起大拇指。其余部分保持源运动不变。

低效示例（重复图像本身已明确表达的信息）：

一位自信的女性身穿炭灰色西装，在现代办公室中面对镜头讲话。

风格多样性： 当构图一致时，写实摄影、卡通、3D 与吉祥物风格的静帧可共用同一运动模板 —— 参考图像自身的渲染风格将完整继承。

Runware 字段映射：referenceImages[0] → image，referenceVideos[0] → video，positivePrompt → instruction_prompt，settings.preserveAudio → save_audio。

混合素材上下文（运动模板、滑块控件、头像 CTA）：animate-beats.md。

必需输入项

• video（字符串 URL）：源 RGB 视频（.mp4）；作为运动与音频源
• image（字符串 URL）：待动画化的参考主体图像

常用可选字段

• resolution：可选 720p（默认）或 1080p
• target_fps：可选 original（默认）、24 或 48
• instruction_prompt（字符串）：关于主体如何遵循源运动的额外引导说明
• save_audio（布尔值，默认 true）
• seed（整数）
• disable_safety_checker（布尔值，默认 false）

示例：上传源素材

curl -X POST "https://api.pruna.ai/v1/files" 
  -H "apikey: ${PRUNA_API_KEY}" 
  -F "content=@/path/to/source-video.mp4"

curl -X POST "https://api.pruna.ai/v1/files" 
  -H "apikey: ${PRUNA_API_KEY}" 
  -F "content=@/path/to/reference-image.png"

将每个响应中的 urls.get（或 https://api.pruna.ai/v1/files/{id}）分别填入 input.video 与 input.image。

示例：异步调用（推荐）

省略 Try-Sync 头。输出视频时长与源视频一致。

curl -X POST 'https://api.pruna.ai/v1/predictions' 
  -H 'Content-Type: application/json' 
  -H "apikey: ${PRUNA_API_KEY}" 
  -H 'Model: p-video-animate' 
  -d '{
    "input": {
      "video": "https://api.pruna.ai/v1/files/source-video-abc123",
      "image": "https://api.pruna.ai/v1/files/reference-image-def456",
      "resolution": "720p",
      "target_fps": "original",
      "instruction_prompt": "Animate the reference subject using the motion from the source video."
    }
  }'

轮询与下载方法详见：pruna-api.md。

示例：同步调用（仅限单次快速测试）

curl -X POST 'https://api.pruna.ai/v1/predictions' 
  -H 'Content-Type: application/json' 
  -H "apikey: ${PRUNA_API_KEY}" 
  -H 'Model: p-video-animate' 
  -H 'Try-Sync: true' 
  -d '{
    "input": {
      "video": "https://api.pruna.ai/v1/files/source-video-abc123",
      "image": "https://api.pruna.ai/v1/files/reference-image-def456"
    }
  }'

典型后续步骤

• 生成或编辑参考主体：p-image、p-image-edit
• 在现有视频中替换人物（非运动迁移）：p-video-replace
• 脚本驱动的说话人视频（非运动迁移）：p-video-avatar
• 流水线中心枢纽：pruna-generative-pipeline
• 多场景运动迁移 + 滑块演示：avatar-multi-scene（animate 行）

关联工作流

生成滑块对比视频： generate_video_comparison.py + avatar-multi-scene 的 animate 行。