Submissions

Submit a video for clipping

Queues a video for AI clipping. Credits are deducted immediately upon submission. Returns the submission id to track progress.

Poll GET /clips/{videoId}/submissions/{submissionId} until status is completed or failed, then retrieve the generated clips from GET /clips/{videoId}/submissions/{submissionId}/clips.

post/clips

Request

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

Request body

video_idstring required

The video_id returned by POST /clips/info

source_language'auto' | 'en' | 'pt'
strategy_idstring nullable

ID of a saved clipping strategy. Omit or pass null to use default AI settings

template_idstring nullable

ID of an edit template from GET /templates to auto-apply to every generated clip. An unknown one answers 404 TEMPLATE_NOT_FOUND before anything is charged

translate_tostring

Language code (ISO 639-1, e.g. en, es) to translate the clips' captions into. Costs more than the plain job, and credits_charged reports what was taken; the surcharge is refunded when the video turns out to be spoken in that language already. Omit to keep the strategy's own setting, or pass "" for no translation.

Response

Response for status 201

idstring required

ID of the created submission. Poll it for progress

video_idstring required

ID of the source video

status'queued' required
credits_chargednumber required

Credits actually deducted from your balance. 0 when the clip was free, including while this workspace has unlimited usage

Changes

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