Skip to Content
Cut.ProDocs
Clipping: strategies

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.

Authorization

apiKey
headerX-Api-Key<token>

Request Body

  1. body
name*string

Unique among your strategies

Length1 <= length <= 32
description?string

For you; the AI does not read it

Lengthlength <= 128
clip_focus?string

What the AI should look for when picking moments, in your own words

Lengthlength <= 512
title_style?string

How the clip titles should be written

Lengthlength <= 512
clip_min_length*number

Shortest clip, in seconds

Range5 <= value <= 3600
clip_max_length*number

Longest clip, in seconds; at least 5 more than clip_min_length

Range10 <= value <= 7200
translate_to?string

Language code (ISO 639-1, e.g. en) the clips' captions are translated into, which costs more per submission. Omit to keep the spoken language

Lengthlength <= 16

Response Body

Response for status 201

application/json
  1. response
id*string

Pass it as strategy_id to POST /videos/{videoId}/submissions or to a monitor

name*string
description*string|null|null
clip_focus*||

What the AI looks for when picking moments

title_style*||

How the clip titles are written

clip_min_length*number

Shortest clip, in seconds

clip_max_length*number

Longest clip, in seconds

translate_to*||

Language the captions are translated into; null keeps the spoken one

is_public*boolean

true for CutPro's ready-made strategies, which cannot be edited or deleted

created_at*string
updated_at*string
POST
/strategies
Example Request
curl -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}'
Example Response
{  "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"}