Sending a video for clipping

Before generating clips, you need a video_id. There are two ways to get one, and both converge on the same next step: calling POST /clips with that video_id (see the Quickstart).

The video must be at least 1 minute long. The maximum duration depends on your plan.

Option A: by public URL

The simplest way. Send the URL of a public video (YouTube, TikTok, Twitch, Kick, Vimeo, etc.) for analysis. Analyzing costs no credits.

curl -X POST https://api.cut.pro/api/v1/clips/info \
  -H "X-Api-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://www.youtube.com/watch?v=..." }'

The response includes video_id, credits_cost (what you will be charged when you submit), current_balance, and the video’s title/duration. Save the video_id and continue to POST /clips.

Option B: uploading your own file

For videos from your computer, the upload is done in three steps with a presigned URL, sending the bytes directly to storage.

Upload limits: maximum 2 GB and extensions .mp4, .mov, .webm, .mkv. The presigned URL expires in 1 hour.

Start the upload

Declare the file name and the content type. The response includes the video_id, the upload_url (where to send the bytes), and expires_in (seconds until it expires).

curl -X POST https://api.cut.pro/api/v1/videos/upload \
  -H "X-Api-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_name": "minha-live.mp4",
    "content_type": "video/mp4"
  }'

Send the bytes to the upload_url

Do a PUT of the file directly to the upload_url. Do not send your API key here (the URL is already signed), and use the same Content-Type you declared in the previous step.

curl -X PUT "UPLOAD_URL" \
  -H "Content-Type: video/mp4" \
  --data-binary @minha-live.mp4

The PUT must return 200 before you continue.

Complete the upload

Register the upload, providing the dimensions and duration of the file (measured on your side). The response includes the video metadata and credits_cost, just like analysis by URL.

curl -X POST https://api.cut.pro/api/v1/videos/upload/complete \
  -H "X-Api-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_id": "VIDEO_ID",
    "file_name": "minha-live.mp4",
    "duration": 5400,
    "width": 1920,
    "height": 1080
  }'

Only call this step after the PUT returns 200. If the file is not in storage, the response is 404 FILE_NOT_FOUND. If the duration is outside the limits, it returns 400 VIDEO_TOO_SHORT or VIDEO_TOO_LONG (with max_duration).

Next step

With the video_id in hand (from either option), submit it for clipping:

Continue in the Quickstart from the “Send for clipping” step (POST /clips).

Getting Started

Workspace and credits

Videos

Clipping

Clips

Templates

Rendering

Publishing

Connections

Sending a video for clipping

Option A: by public URL

Option B: uploading your own file

Next step

​Option A: by public URL

​Option B: uploading your own file

​Next step

Option A: by public URL

Option B: uploading your own file

Next step