Create a clipping strategy
Saves how clips should be picked, titled and sized. Needs a plan with custom strategies: 403 CUSTOM_PROCESSORS_NOT_ALLOWED otherwise. 400: INVALID_CLIP_MIN_LENGTH and INVALID_CLIP_MAX_LENGTH when a length is outside what clipping supports, INVALID_CLIP_LENGTH when the minimum is not below the maximum, INVALID_CLIP_LENGTH_RANGE when they are less than 5 s apart, INVALID_TRANSLATE_LANGUAGE for a language captions cannot be translated into.
apiKeyX-Api-Key<token>- body
name*stringUnique among your strategies
1 <= length <= 32description?stringFor you; the AI does not read it
length <= 128clip_focus?stringWhat the AI should look for when picking moments, in your own words
length <= 512title_style?stringHow the clip titles should be written
length <= 512clip_min_length*numberShortest clip, in seconds
5 <= value <= 3600clip_max_length*numberLongest clip, in seconds; at least 5 more than clip_min_length
10 <= value <= 7200translate_to?stringLanguage code (ISO 639-1, e.g. en) the clips' captions are translated into, which costs more per submission. Omit to keep the spoken language
length <= 16Response for status 201
application/json- response
id*stringPass it as strategy_id to POST /videos/{videoId}/submissions or to a monitor
name*stringdescription*string|null|nullclip_focus*||What the AI looks for when picking moments
title_style*||How the clip titles are written
clip_min_length*numberShortest clip, in seconds
clip_max_length*numberLongest clip, in seconds
translate_to*||Language the captions are translated into; null keeps the spoken one
is_public*booleantrue for CutPro's ready-made strategies, which cannot be edited or deleted
created_at*stringupdated_at*stringcurl -X POST 'https://api.cut.pro/api/v1/strategies' \ -H 'Content-Type: application/json' \ -d '{ "name": "string", "clip_min_length": 5, "clip_max_length": 10}'{ "id": "string", "name": "string", "description": null, "clip_focus": null, "title_style": null, "clip_min_length": 0, "clip_max_length": 0, "translate_to": null, "is_public": true, "created_at": "string", "updated_at": "string"}List clipping strategies GET
Returns CutPro's ready-made strategies first, then the ones your workspace created. Without a `strategy_id`, `POST /videos/{videoId}/submissions` and monitors use the default AI settings.
Update a clipping strategy PATCH
Changes only the fields sent, with the same `400` codes as creating one, checked against the result. Submissions already made keep the settings they ran with. `403 STRATEGY_PROTECTED` on CutPro's ready-made ones.