Skip to Content
Cut.ProDocs
AI characters

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.

Authorization

apiKey
headerX-Api-Key<token>

Query Parameters

media_id*string

The media_id from POST /personas/sources/upload, or any video already in the library.

quality?string

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.

Value in"economy""standard""high"
replace?string

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.

Value in"head""person""none"
style?string

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.

Value in"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 Body

Response for status 200

application/json
  1. response
media_id*string
quality*string

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.

Value in"economy""standard""high"
replace*string

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.

Value in"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.

Value in"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"null
seconds*number

Measured duration of the video.

credits*number

Price of the persona video, in credits.

GET
/personas/swap/quote
Example Request
curl -X GET 'https://api.cut.pro/api/v1/personas/swap/quote?media_id=string'
Example Response
{  "media_id": "string",  "quality": "economy",  "replace": "head",  "style": "cel",  "seconds": 0,  "credits": 0}