Personas

Upload a source video

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.

post/personas/sources/upload

Request

  • Base URL: https://api.cut.pro/api/v1
  • URL: https://api.cut.pro/api/v1/personas/sources/upload
  • Auth: API key in header X-Api-Key

Request body

file_namestring required

Original file name; its extension must be .mp4 or .mov.

file_sizenumber required

Size of the file in bytes.

content_typestring

MIME type, video/mp4 or video/quicktime. Must match the bytes you PUT.

Response

Response for status 200

media_idstring required

Pass it to the complete call, then to GET /personas/swap/quote and POST /personas/{id}/videos.

upload_urlstring required

Presigned PUT URL. Upload the raw bytes here.

expires_innumber required

Seconds until upload_url expires.

Changes

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