Videos

Start an upload

Returns the generated video_id plus whatever the file's size requires to upload it directly to storage, then call POST /videos/upload/complete to register the upload and get the credit cost.

When mode is single, PUT the bytes to upload_url with the same Content-Type you declared here.

When mode is multipart the file is past the storage provider's single-PUT ceiling: split it into part_size-byte chunks and PUT each one to the matching entry of part_urls (index 0 is part 1, the last part may be shorter). Collect each response's ETag header and post them to POST /videos/upload/multipart/complete.

Max file size comes from your plan — a FILE_TOO_LARGE response reports the effective ceiling in max_size. Extensions: .mp4, .mov, .webm, .mkv.

post/videos/upload

Request

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

Request body

file_namestring required

Original file name. Used to detect the extension and as a fallback title.

file_sizenumber required

Size of the file in bytes. The ceiling comes from your plan.

content_typestring

MIME type — defaults to video/mp4. Must match the bytes you PUT.

Response

Response for status 200

OR

Changes

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