P-Video Replace: swap the person in a video
Put the person from your pictures into an existing video in place of the one there, keeping the motion, scene and sound. 720p, as long as the source.
POST /api/v1/nodes/video-p-video-replace
How it works
Your agent pays for itself

1Needs something

2Finds it on TollNode

3Pays a few cents

4Gets the result
Two ways to use P-Video Replace: swap the person in a video
Way 1 · Pay per call (x402)
For AI agents, no sign-up
Your agent sends the request, gets a 402 with the exact price (from $0.204 per video), signs a USDC payment on Base and retries. Nothing is collected unless the call succeeds.
npx agentcash add https://tollnode.comnpx agentcash@latest fetch https://tollnode.com/api/v1/nodes/video-p-video-replace -m POST -b '{"video":"https://tollnode.com/examples/video-p-video.mp4","images":["https://tollnode.com/examples/video-p-video-avatar.jpg"],"max_seconds":10}'Way 2 · Account + API key
For apps and teams
Create a free account, load a balance with USDC on Base, create an API key and call any node. Same prices; each successful call is deducted from your balance.
curl -X POST https://tollnode.com/api/v1/nodes/video-p-video-replace \
-H "Authorization: Bearer $TOLLNODE_API_KEY" \
-H "content-type: application/json" \
-d '{"video":"https://tollnode.com/examples/video-p-video.mp4","images":["https://tollnode.com/examples/video-p-video-avatar.jpg"],"max_seconds":10}'Step-by-step, with code in JavaScript and Python: full guide for P-Video Replace: swap the person in a video.
Input
| Field | Type | Notes |
|---|---|---|
| seed | integer | |
| video* | string | Source video as an MP4 link (https); the result is as long as this video. Or send the file inline as a base64 data: URI (up to 4.5 MB)Limit: https link or base64 data: URI up to 4.5 MB |
| images* | array | 1 to 3 pictures of the person to place into the video (https URLs). Or send the file inline as a base64 data: URI (up to 4.5 MB)Limit: 1 to 3 items; each https link or base64 data: URI up to 4.5 MB |
| max_seconds | enum | Longest the source video can be; sets the price. Longer videos are refused before anything runs, and not charged. Default 5 (5, 10, 15, 20) |
| instruction_prompt | string | Optional: who replaces whom, or other placement notesLimit: up to 1,000 characters |
Example response
{
"videos": [
"https://tollnode.com/api/v1/files/00000000-0000-0000-0000-000000000000/0"
],
"aiGenerated": true
}FAQ
- What does the P-Video Replace: swap the person in a video node return?
- Put the person from your pictures into an existing video in place of the one there, keeping the motion, scene and sound. 720p, as long as the source.
- How much does one call cost?
- from $0.204 in USDC on Base per video (one call = one short video), charged only when it succeeds, depending on max_seconds (5: $0.204, 10: $0.406, 15: $0.609, 20: $0.811). No sign-up, subscription or API key.
- What happens if the call fails?
- You are not charged. TollNode checks your signed payment first, runs the node, and only collects the payment if the result is usable. A failed, empty or timed-out call is never settled, so there is nothing to refund.
- How does an AI agent pay?
- With x402. The first request returns HTTP 402 and the exact price. Any x402 wallet signs the USDC payment and retries automatically. In Claude Code or Cursor, run npx agentcash add https://tollnode.com once.
- Can I use an API key instead?
- Yes. Create a free account, add funds in USDC on Base, create an API key and send it as Authorization: Bearer. Each successful call is deducted from your balance at the same price; failed calls cost nothing.