Get a persona video
Returns one persona video. Poll it every 10 seconds while status is processing; download_url is set once ready.
Request
- Base URL: https://api.cut.pro/api/v1
- URL: https://api.cut.pro/api/v1/personas/{id}/videos/{videoId}
- Auth: API key in header X-Api-Key
Path parameters
Response
Response for status 200
What kind of video this is. swap replaces the person in a library video with the persona; product is a product ad the persona talks in, made on the web app.
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.
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.
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.
The persona version (from the persona's versions) whose photo the video was made from.
Measured duration of the source video, which is what was priced.
Credits debited for this video. Refunded automatically when it fails.
Edit created from the result, ready for POST /renders and POST /posts. Set once ready.
Signed URL of the resulting MP4, valid for six hours. Set once ready; once handed out, the video counts as downloaded and its credits can no longer be asked back.
Signed URL of the cover image, valid for six hours.
Expected seconds from created_at until the video is ready, refined as the job advances. Only while processing.
Why the last generation failed, null otherwise: COPYRIGHT_BLOCKED (the scene looks like copyrighted material), REAL_FACES_BLOCKED (a real face is too prominent), SAFETY_BLOCKED (the provider's content rules) and MEDIA_REJECTED (refused for another reason); for any refusal change the traits, the photos or the video. MEDIA_FAILED and MEDIA_UNAVAILABLE (generation broke, retry), INSUFFICIENT_CREDITS, TIMEOUT, OUTPUT_CHECK_FAILED (the video did not keep the persona on the right person even after one free redo; try another video or pick the person). Credits of a failed generation are refunded automatically.
up liked, down disliked, null not rated.
Set with a down vote; one of the video feedback reasons.
Changes
No recorded changes to this operation across all 1 revision of this API.