Skip to Content
Cut.ProDocs
AI characters

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.

Authorization

apiKey
headerX-Api-Key<token>

Request Body

  1. body
file_name*string

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

file_size*number

Size of the file in bytes.

content_type?string

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

Response Body

Response for status 200

application/json
  1. response
media_id*string

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

upload_url*string

Presigned PUT URL. Upload the raw bytes here.

expires_in*number

Seconds until upload_url expires.

POST
/personas/sources/upload
Example Request
curl -X POST 'https://api.cut.pro/api/v1/personas/sources/upload' \  -H 'Content-Type: application/json' \  -d '{  "file_name": "string",  "file_size": 0}'
Example Response
{  "media_id": "string",  "upload_url": "string",  "expires_in": 0}