共享生成策略

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

1. 随机种子仪式 —— 始终为第一步；通过“求和取模”法推导各维度轴。
2. 生成多样性 —— 使用明确提示词；每次会话中轮换 ≥2 个场景维度轴。
3. 质量检查清单 —— 打开输出文件并人工判定是否通过，再进入下一环节。

p-video-replace（Pruna）

P-Video-Replace 接收一段源 RGB 视频及一张或多张参考图像，将人物、服装、物体/道具，或其组合置入原视频场景中，同时完整保留原始动作、表演、时序、摄像机运动与场景结构。

给定源视频、参考图像及清晰的 instruction_prompt，该模型可将参考图像中的身份信息精准置入视频——而不仅限于人脸替换。

完整 P-API 参数说明：p-video-replace 模型文档 · 运维指南（Runware 托管）：产品与服装 · 场景重铸

共用 HTTP 模式：pruna-api.md

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

根据用户实际需求选择模型——二者任务本质不同。

使用 p-video-replace：当用户拥有真实拍摄素材，并希望在单次调用中完成人物、服装/穿搭、产品/道具或其混合替换（如角色重铸、UGC 内容刷新、服装更换、货架 SKU 替换、手持产品置换）。需在 instruction_prompt 中为每个参考图像明确映射对应位置。

使用 p-video-animate：当用户拥有人像或角色静态图，并希望其基于另一段模板视频的动作进行表演（如表情包混剪、运动迁移滑块、角色变体生成）。

核心特性

• 顶级视觉质量；完整保留源视频的动作、时序、摄像机路径与音频
• 单次请求支持多张参考图像 —— 最多4 张（支持多人、多 SKU 或混合槽位）
• 高效推理：约 3.58 秒生成每 1 秒视频（方向性指标；具体耗时依参数设置而异）
• 计费标准：$0.03/秒（720p），$0.06/秒（1080p）输出视频时长

可替换内容类型

反模式示例：使用泛化表述，例如 “替换视频中的人物”，却未指明源视频中哪个对象被替换、各参考图对应哪个位置。身份信息来自 images；正确的槽位映射则完全依赖 instruction_prompt。

本地化替换模式：明确命名源视频中需替换的具体元素，列出所有需保留的要素，并以 “仅 [X] 应发生改变；其余全部与源视频一致。” 收尾——此格式为纯服装或纯物体替换任务所必需。

多参考图替换序列：推荐使用 multi_job（每张图单独一次 API 调用）并配合逐图定制提示词；默认采用 p-video-avatar 类型源（手持产品、桌面道具、单人讲话镜头）。反模式详见 visual-variety-bible.md。

生成前准备

1. 生成多样性 —— 执行种子仪式 + 维度轴轮换；若已设定，则将 seed 显式传入。
2. 与用户确认以下内容：

• video URL —— 源 RGB .mp4 文件（动作与音频来源；请先上传至 /v1/files）
• images —— 1–4 张身份参考图像 URL（请预先分别上传）
• resolution：设为 720p 或 1080p
• target_fps：设为 original、24 或 48
• instruction_prompt —— 生产级质量必需项：需将每个源视频槽位（如左侧人物、白色瓶子、红色连衣裙）映射至对应参考线索；明确说明不变更的内容（如摄像机、音频、背景）
• 替换意图 —— 明确是人物替换、纯服装替换、纯物体替换还是混合替换（应在撰写提示词前确定）
• 可选字段：save_audio、seed、disable_safety_checker

对输入与输出执行 p-video-replace-quality-checklist.md 流程。

批量运行：当多个独立源视频需分别执行替换时，请一次性创建全部预测任务（并行异步批次），随后统一轮询结果。参见 parallel-execution.md。评审阶段建议以 720p 分辨率生成变体；审批通过后，对合格条目重新以 1080p 分辨率运行。

确保替换成功的关键要点

两个输入至关重要：（1）images —— 定义替换后的外观；（2）instruction_prompt —— 指明每张参考图像对应替换源视频中的哪个元素。

人物替换（UGC 重铸 —— 若存在多个相似人物，请使用位置映射）：

将群组中央正在调整太阳镜的男子，替换为参考图像中的男子。
保留动作、音频、摄像机、光照，以及源视频中其余四位男子的全部细节。

人物+手持道具（需消歧义 —— 否则参考图可能错误落在手机/排球而非面部）：

将跪在救生筏上、伸手抓向排球并大喊的络腮胡男子，替换为参考图像中的男子。
保留救生筏、海洋、漂浮的排球、动作、音频、摄像机及光照，全部与源视频完全一致。

纯服装替换（同一模特，更换穿搭）：

将女子所穿的橄榄绿 T 恤，替换为参考图像中的白色牛津纺衬衫。
保留她的面部、头发、右手所持的耳机盒、手势、语音、摄影棚、光照、摄像机及音频。
仅她所穿的上衣应发生变化；其余全部与源视频一致。

物体替换（手持 SKU）：

将女子右手所持的哑光黑耳机盒，替换为参考图像中的赤陶色多肉植物。
保留她的面部、头发、橄榄绿 T 恤、手势、语音、摄影棚、光照、摄像机及音频。
仅她手中所持物体应发生变化；其余全部与源视频一致。

混合替换（单次调用完成服装 + 产品替换）：

将橄榄绿 T 恤替换为参考图像 1 中的白色牛津纺衬衫；同时将耳机盒替换为参考图像 2 中的咖啡保温杯。
保留她的面部、头发、手势、语音、摄影棚、光照、摄像机及音频。
上衣与手持物体均应变化；其余全部与源视频一致。

混合替换（咖啡馆场景 —— 面部 + 包包 + 夹克）：

用第一张参考图替换女子（含面部与酒红色包包）。用第二张参考图替换男子的藏青色飞行员夹克为橄榄绿绒面革夹克。
保留桌面、杯子、笑声节奏及摄像机环绕轨迹。

若用户仅提供非结构化照片，可用 p-image / p-image-edit 预处理参考图。

限制条件

• 目标模糊 —— 如 “替换产品” 将迫使模型猜测；必须明确命名物体及其在源视频中的位置。
• 画面中目标过小 —— 如产品远离镜头手持、或仅角落贴纸形式呈现 → 替换质量下降；目标需占据足够画面比例。
• 像素级精准保留 —— 如需背景 Logo、球衣号码、条形码等帧间完全一致 → 请使用带遮罩的修复（inpainting），而非 replace。
• replace 是将参考图置入场景 —— 小字号标签文字或纹理图案可能在多次运行间产生偏移。

Runware 字段映射：inputs.video → video，referenceImages → images，positivePrompt → instruction_prompt。

必需输入

• video（字符串 URL）：源 RGB 视频（.mp4）；作为动作与音频来源
• images（1–4 个字符串 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-person-a.png"

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

将各响应中的 urls.get（或 https://api.pruna.ai/v1/files/{id}）分别用于 input.video 和 input.images。

示例：异步调用（推荐）—— 单次调用替换两人

省略 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-replace' 
  -d '{
    "input": {
      "video": "https://api.pruna.ai/v1/files/source-video-abc123",
      "images": [
        "https://api.pruna.ai/v1/files/reference-person-a-def456",
        "https://api.pruna.ai/v1/files/reference-person-b-ghi789"
      ],
      "resolution": "720p",
      "target_fps": "original",
      "instruction_prompt": "将左侧女子（橄榄色外套）替换为第一张参考图。将右侧男子（藏青色夹克）替换为第二张参考图。保留步行节奏、摄像机跟随及音频。"
    }
  }'

轮询与下载方式详见 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-replace' 
  -H 'Try-Sync: true' 
  -d '{
    "input": {
      "video": "https://api.pruna.ai/v1/files/source-video-abc123",
      "images": [
        "https://api.pruna.ai/v1/files/reference-image-def456"
      ]
    }
  }'

典型后续步骤

• 从静态图迁移动作（不同模型）：p-video-animate
• 生成或编辑参考人像：p-image、p-image-edit
• 基于脚本生成全新讲话镜头（非就地替换）：p-video-avatar
• 多场景滑块演示： generate_video_comparison.py
• 流水线中心：pruna-generative-pipeline

相关工作流

滑块对比序列： generate_video_comparison.py + pruna-generative-pipeline 配方 N。