Videos

Complete an upload

Registers a finished upload, captures its dimensions/duration, and returns the video metadata together with the exact credit cost, in the same payload shape as POST /clips/info. Pass the returned video_id to POST /clips to start a clipping submission.

Call this only after the PUT to upload_url returned 200. If the file is missing from storage, this returns FILE_NOT_FOUND.

post/videos/upload/complete

Request

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

Request body

video_idstring required

The video_id returned by POST /videos/upload.

file_namestring required

Original file name — used as the video title.

durationnumber required

Video duration in seconds.

widthnumber required

Video width in pixels.

heightnumber required

Video height in pixels.

Response

Response for status 200

idstring required

The registered video. Pass it to POST /clips as video_id.

titlestring required
descriptionstring required
authorstring required
platformstring required
durationnumber required
thumbnail_urlstring required
credits_costnumber required

Cost of clipping this video. Charged on submit unless credits_unlimited is true.

credits_originalnumber required

Credit cost before any plan discount.

discount_percentnumber required

Discount applied by the current plan (0-100).

force_watermarkboolean required

true if generated clips will carry a CutPro watermark.

current_balancenumber required

Current workspace credit balance.

credits_unlimitedboolean required

true while usage is free for this workspace: the job runs without consuming credits and is never rejected for lack of balance.

Changes

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