POST /v3/recast/v1/jobs starts a job, and you read the result with GET /v3/recast/v1/jobs/{id} or a webhook. Calls need a pk_live_ key, the same as the rest of the API; see Authentication. From an AI assistant, use the recast_video tool on the MCP server.
Modes
Faces come from your own avatars. Make one with create_avatar or the avatars API first. A reference image that shows a real person’s face counts as an uploaded likeness, and uploaded likenesses are not accepted at launch.
Price
A 15-second recast costs about $6 (245 credits). It is charged once when the job starts, and refunded in full if the job fails. Anything refused by the checks below is refused before the charge, so it costs nothing. Ask
POST /v1/estimate for the exact number first:
201 Response
Start a recast
An
https link to the clip, an .mp4 from 3 to 15 seconds long. Upload a local file with the upload API first.Must be
true. It confirms: “I own this video or have the right to edit it, and I have permission from everyone shown and everyone whose likeness I add.” It is stored with the time and your IP address.Up to 3 entries of
{ "avatar": "<your avatar name or id>", "who": "the man on the right" }. who says which person in the clip becomes that avatar; leave it out when there is one person. Required for recast.Up to 4
https images: the new look for motion_transfer, the new thing for object_swap (required there).object_swap only, required: what to replace, for example "the red sneakers". At most 120 characters.Optional
https URL. It gets one POST when the job ends, with event recast.completed, signed like every Percify webhook. See Webhooks.Reuse the same value on retries to get the original job back instead of paying again. Kept for 24 hours.
201 Response
Read a recast
GET /v3/recast/v1/jobs/{id} returns:
framing → rendering → checking → done. Or failed (credits refunded), refused (never charged) or taken_down (removed after a report).Whether the visible AI label is on the video. It always is for anything other than your own avatar.
wait_for_job with jobType: "recast" on the MCP server.
Limits
- Clips from 3 to 15 seconds, output at 720p.
- Up to 3 avatars and up to 4 reference images.
- The output carries a visible “made with Percify” AI label.
Safety and consent
Every job is checked before it is charged and again before it is delivered: frames of your clip, your avatars and references, the new first frame, and frames of the finished video.- Never allowed: sexual or nude content of a real or identifiable person, and anything involving someone who may be under 18. These are refused even when the check is unsure, and refused if the check itself cannot run.
- Real public figures (celebrities, politicians, athletes, executives, well-known creators) cannot be recast.
- Faces come from your own avatars. Recast someone only with their permission.
Report a recast
If you are shown in a video made with Recast, or act for someone who is, report it. No account is needed:relationship is i_am_shown, representative or other. We review every report and remove the video within 48 hours of a valid report. A report we have not resolved within 48 hours is taken down automatically. You can also email [email protected] with the link.