p-video-replace

Use when the user wants to swap a person, outfit, or product inside existing video, in-footage recast, wardrobe change, or product replacement while keeping camera motion and audio.

Pruna AI@pruna-ai

Install

openclaw skills install @pruna-ai/p-video-replace

p-video-replace (Pruna)

P-Video-Replace takes a source RGB video and one or more reference images, then swaps characters, clothing, objects/props, or a combination into the scene while preserving the original motion, acting, timing, camera movement, and scene structure.

Given a source video and reference images plus a clear instruction_prompt, the model places referenced identities into the video — not only face swap.

Full P-API parameters: p-video-replace model docs · operational guides (Runware host): product & wardrobe · recasting scenes

Shared HTTP patterns: pruna-api.md

p-video-replace vs p-video-animate

Pick the model from what the user is trying to do — these are different jobs.

	p-video-replace	p-video-animate
User question	How can I replace this person in this video?	How can I animate this picture with some motion?
Goal	Swap identity into existing footage	Drive a still with motion from another clip
Source video	The final scene (actors, audio, environment stay)	A motion template (acting, camera, timing only)
Reference images	`images` — 1 to 4 URLs in one call (multiple people)	`image` — one subject per call
Output look	Same video structure; new face/body from references	New video styled like the still, following template motion

Use p-video-replace when the user has real footage and wants to swap people, clothing/outfits, products/props, or a mix in one call (recast, UGC refresh, wardrobe change, shelf SKU swap, in-hand product). Map each reference slot in instruction_prompt.

Use p-video-animate when the user has a portrait or character still and wants it to perform using motion copied from a separate template video (meme remix, motion-transfer slider, persona variants).

Key features

Top visual quality; preserves source motion, timing, camera path, and audio
Multiple reference images in one request — up to 4 images (multi-person, multi-SKU, or mixed slots)
Efficient inference: ~3.58s generation per 1s of video (directional; varies by settings)
Pricing: $0.03/s (720p), $0.06/s (1080p) of output video

What you can replace

Swap type	Reference still shows	`instruction_prompt` must
Character	New person / cast	Name who in the source is replaced; keep motion and scene
Clothing	Outfit on similar pose	Replace only garments; keep face, body motion, background
Object / product	Hero packshot or prop	Replace only the object (bottle, bag, shelf SKU); keep hands and camera
Mixed	1–4 refs for people + props + wardrobe	Map each image index to a specific slot in the source

Anti-pattern: Generic lines like "Replace the person in the video" without naming what in the source and what from each reference. Identity comes from images; correct slot mapping comes from instruction_prompt.

Localized swap pattern: name the specific source element to replace, list everything to preserve, close with "Only the [X] should change; everything else stays as the source." — required for clothing-only and object-only jobs.

Multi-reference replace reels: Prefer multi_job (one image per API call) with per-reference prompts; default p-video-avatar sources (product in hand, desk prop, solo talking head). Anti-patterns: visual-variety-bible.md.

Before generating

Generation diversity — ritual seed + axis rotation; pass as seed when set.
Confirm with the user:

video URL — source RGB .mp4 (motion + audio source; upload to /v1/files first)
images — 1–4 identity reference URLs (upload each image first)
resolution: 720p or 1080p
target_fps: original, 24, or 48
instruction_prompt — required for production quality: map each source slot (left person, white bottle, red dress) to reference cues; say what not to change (camera, audio, background)
Swap intent — character vs clothing-only vs object vs mixed (decide before writing the prompt)
Optional save_audio, seed, disable_safety_checker

Run p-video-replace-quality-checklist.md on inputs and outputs.

Batch runs: when several independent source videos each need replacement, create all predictions in one parallel async batch, then batch-poll. See parallel-execution.md. Fan out variants at 720p for review; re-run approved rows at 1080p.

Making replacement work

Two inputs matter: (1) images — replacement look; (2) instruction_prompt — which source element each image replaces.

Factor	Guidance
Reference stills	Bare product/garment packshots — no person, hands, or props in frame
Reference count	One still per slot; up to 4 per call
Multi-slot scenes	One `instruction_prompt` listing left/right, shelf order, or in-hand object; index refs ("first reference", "reference image 2")
Variant rows	One image per API call; per-call `instruction_prompt` naming source subject + reference cues
Framing match	Chest-held product → vertical packshot; torso garment → flat-lay front face; match scale to source
Held objects	Name the person as swap target; list the prop as preserved — or the ref may land on the object
Character audio	`save_audio: true` — voice stays from the source clip, not the reference portrait
Shot alignment	Match framing/scale between source and reference (especially products)

Character (UGC recast — use position mapping when several similar figures):

text

Replace the man in the centre of the group, the one adjusting his sunglasses, with the man from the reference.
Preserve motion, audio, camera, lighting, and the other four men exactly as in the source.

Character with held prop (disambiguate — ref can land on phone/volleyball instead of face):

text

Replace the bearded man kneeling on the raft, reaching toward the volleyball and yelling, with the man from the reference.
Preserve the raft, ocean, drifting volleyball, motion, audio, camera, and lighting exactly as in the source.

Clothing only (same model, new outfit):

text

Replace the olive-green t-shirt the woman is wearing with the white oxford button-down from the reference.
Preserve her face, hair, the earbuds case in her right hand, gestures, speech, studio, lighting, camera, and audio.
Only the top she is wearing should change; everything else stays as the source.

Object (in-hand SKU):

text

Replace the matte-black earbuds case in the woman's right hand with the terracotta succulent from the reference.
Preserve her face, hair, olive t-shirt, gestures, speech, studio, lighting, camera, and audio.
Only the object in her hand should change; everything else stays as the source.

Mixed (wardrobe + product in one call):

text

Replace the olive-green t-shirt with the white oxford from reference image 1, AND replace the earbuds case with the coffee tumbler from reference image 2.
Preserve her face, hair, gestures, speech, studio, lighting, camera, and audio.
Both the top and the hand object should change; everything else stays as the source.

Mixed (cafe — face + bag + jacket):

text

Replace the woman with the first reference (face and burgundy bag). Replace the man's navy bomber with the olive suede jacket from the second reference.
Preserve table, cups, laughter timing, and camera orbit.

Prepare references with p-image / p-image-edit when the user only has loose photos.

Limits

Vague targets — "replace the product" forces the model to guess; name the object and its location in the source.
Tiny on-screen targets — product held far from camera or corner stickers → swap quality drops; target must occupy enough of the frame.
Pixel-perfect preservation — background logos, jersey numbers, barcodes that must stay frame-identical → use inpainting with a mask, not replace.
Replace lifts the reference into the scene — small label text or patterns may drift between runs.

Runware field map: inputs.video → video, referenceImages → images, positivePrompt → instruction_prompt.

Required input

video (string URL): source RGB video (.mp4); motion and audio source
images (array of 1–4 string URLs): identity reference image(s) to place into the video

Common optional fields

resolution: 720p (default) or 1080p
target_fps: original (default), 24, or 48
instruction_prompt (string): how to place people from the reference images into the scene
save_audio (boolean, default true)
seed (integer)
disable_safety_checker (boolean, default false)

Example: upload source assets

bash

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"

Use each response urls.get (or https://api.pruna.ai/v1/files/{id}) in input.video and input.images.

Example: async (recommended) — two people, one call

Omit Try-Sync. Output duration follows the source video.

bash

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": "Replace the woman on the left (olive coat) with the first reference. Replace the man on the right (navy jacket) with the second reference. Preserve walking pace, camera tracking, and audio."
    }
  }'

Poll and download: pruna-api.md.

Example: sync (single quick test only)

bash

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"
      ]
    }
  }'

Typical next steps

Motion-transfer from a still (different model): p-video-animate
Generate or edit reference portraits: p-image, p-image-edit
New talking-head clip from script (not in-place replacement): p-video-avatar
Multi-scene slider demos: generate_video_comparison.py
Pipeline hub: pruna-generative-pipeline

Related workflow

Slider comparison reels: generate_video_comparison.py + pruna-generative-pipeline recipe N.