Price a swap video
Measures a library video and returns what swapping its person for a persona costs at the given quality. Nothing is charged. Pass the returned credits to POST /personas/{id}/videos with type: swap and the same quality, which refuses with PRICE_CHANGED if the price is different. The price follows only the quality, the length and the style: the rate per second plus a small fixed amount per second for the scenes that keep the person the same across cuts (none with replace none, which needs a style; any other replace costs the same), and a style adds a traced frame for about every four seconds. How many scenes the video really has never changes it.
VIDEO_DURATION_OUT_OF_RANGE and VIDEO_UNSUPPORTED (format, size or resolution) follow video_limits of GET /personas/catalog for that quality; a video refused at standard may still fit high.
apiKeyX-Api-Key<token>media_id*stringThe media_id from POST /personas/sources/upload, or any video already in the library.
quality?stringeconomy 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.
"economy""standard""high"replace?stringWhat 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.
"head""person""none"style?stringRedraws 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.
"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"Response for status 200
application/json- response
media_id*stringquality*stringeconomy 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.
"economy""standard""high"replace*stringWhat 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.
"head""person""none"style*|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.
"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"nullseconds*numberMeasured duration of the video.
credits*numberPrice of the persona video, in credits.
curl -X GET 'https://api.cut.pro/api/v1/personas/swap/quote?media_id=string'{ "media_id": "string", "quality": "economy", "replace": "head", "style": "cel", "seconds": 0, "credits": 0}Upload a reference photo POST
Sends one photo of a real person as `multipart/form-data`, to make a persona that looks like them. Only the user's own face, as an adult, is allowed: `own_face_adult` must be `true` and is the user's statement of that. JPEG, PNG, WebP or HEIC up to 10 MB. A close, sharp photo of the face gives the most faithful result. Pass the returned `id` in `face_ids` of `POST /personas` within 24 hours. Up to 6 photos per persona.
Upload a source video POST
Starts the upload of the video whose person will be swapped for a persona. Returns a `media_id` and a presigned PUT URL: PUT the raw bytes to `upload_url` with the same `Content-Type`, then call `POST /personas/sources/upload/complete`. MP4 or MOV only, within `video_limits` of `GET /personas/catalog`. The video goes to the workspace library and counts toward its storage. A video already in the library needs no upload: use its id as `media_id`.