Personas

Create a persona video

Starts a video with a saved persona. type picks the kind of video; today the only one is swap, which keeps the scene, camera, motion and sound of a library video and replaces its main person with the persona. quality (default standard) and replace (default person) pick how; style (none by default) redraws it in a drawing technique; quote and create with the same quality and style. version_id picks which of the persona's versions to use, the current one when left out. Charged per second of the source, plus a small amount per scene where the person appears, even on a workspace with unlimited usage, and refunded automatically if it fails. Picking a target never raises the price above the quote.

Price it first with GET /personas/swap/quote and send that credits: when the server measures a different price it refuses with 409 PRICE_CHANGED and the right one in extra, so nothing is ever charged above what was confirmed.

Responds 202. Poll GET /personas/{id}/videos/{videoId} every 10 seconds until ready or failed; the result also lands in the library with an edit_id for POST /renders and POST /posts. VIDEO_IN_PROGRESS means this persona is already working on the same version with the same video.

post/personas/{id}/videos

Request

  • Base URL: https://api.cut.pro/api/v1
  • URL: https://api.cut.pro/api/v1/personas/{id}/videos
  • Auth: API key in header X-Api-Key

Path parameters

idstring required

Request body

type'swap' required

The kind of video to make; only swap is made here.

media_idstring required

Library video whose person is replaced.

quality'economy' | 'standard' | 'high'

economy is standard at a lower resolution, upscaled to 1080p, and the cheapest. standard follows the persona's traits, up to video_limits.standard.max_seconds. high also follows the persona's photos, keeps the face closest to them and takes longer videos, at a higher price; prefer it for personas made from face photos.

replace'head' | 'person' | 'none'

What of the video's main person becomes the persona: head changes only the head and hair and keeps the body and outfit, person replaces the whole person, body and outfit included, none replaces nobody and only applies the style, which then is required.

style'cel' | 'felt' | 'yarn' | 'sketch' | 'toy' | 'grotesque' | 'painterly' | 'graphic' | 'gouache' | 'sculptural' | 'lowpoly' | 'toon' | 'cinematic' | 'flat' | 'neon' | 'editorial' | 'comic' | 'pixel' | 'plush' | 'embroidery' | 'mosaic' | 'stainedglass' | 'chalk' | 'silent' | 'thermal' | 'hologram'

Redraws the whole video, people and scene, in an animation, illustration, material or camera look while keeping its camera and motion, for example cel (hand-painted 2D animation), felt (felt puppet stop motion), toy (rounded toy 3D), pixel (pixel art), stainedglass (stained glass) or silent (1920s silent film). The whole person is replaced, whatever replace says, unless it is none. Not available at quality: high past video_mid_max_seconds.

version_idstring

A persona version id from versions. Defaults to the current version.

Response

Response for status 202

idstring required

Persona video id.

status'processing' required
credits_chargednumber required

Credits debited now. Refunded automatically if the video fails.

Changes

No recorded changes to this operation across all 1 revision of this API.