Skip to main content
Recast takes a short clip and changes who or what is in it while keeping everything that made it work: every movement, head turn, lip movement, the camera and the timing, with the original sound. 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

string
required
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.
string
recast (default), motion_transfer or object_swap.
object[]
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.
string[]
Up to 4 https images: the new look for motion_transfer, the new thing for object_swap (required there).
string
object_swap only, required: what to replace, for example "the red sneakers". At most 120 characters.
string
Optional description of the new scene or look, at most 400 characters.
string
Optional https URL. It gets one POST when the job ends, with event recast.completed, signed like every Percify webhook. See Webhooks.
string
Reuse the same value on retries to get the original job back instead of paying again. Kept for 24 hours.
201 Response
An object swap:

Read a recast

GET /v3/recast/v1/jobs/{id} returns:
string
framing → rendering → checking → done. Or failed (credits refunded), refused (never charged) or taken_down (removed after a report).
string | null
The finished MP4 when done, hosted on cdn.percify.io, with the original sound.
string | null
The new first frame the video was built from.
boolean | null
Whether the visible AI label is on the video. It always is for anything other than your own avatar.
string
On refused: MODERATION_REJECTED or CONSENT_REQUIRED, with a reason.
A recast usually takes a few minutes. Poll every 10 to 20 seconds, use the webhook, or call 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.
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.
You may not use Recast to put a person’s likeness into a video without their consent, to impersonate anyone, to deceive, or to harass. Accounts that do are closed. Refused requests are logged.

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.

Errors

Last modified on November 16, 2026