Skip to main content
POST
See Video clipping for what the feature does, the clipping minutes it uses and its limits.
Clipping takes several minutes. This endpoint only starts it and returns the clipping id: poll Get a Clipping until the status is completed or failed.

​
Clipping minutes

On Postiz Cloud a clipping spends one clipping minute for every minute of the source video, from the same monthly allowance the agent and MCP use:
  • With no minutes left the request is refused with 402 and nothing is charged.
  • The minutes are charged once the real length of the video is known. A video longer than the minutes left fails the clipping (the error of Get a Clipping says so) and nothing is charged.
  • A clipping that fails without producing a single clip gives the minutes back.
Starting a clipping and polling its status do not count against the hourly rate limit, which applies to the create post endpoint only. Clipping has its own caps: one running clipping per organization and 20 starts a day, both answered with 429.

Authorizations

​
Authorization
string
header
required

Your Postiz API key

Body

application/json
​
url
string<uri>
required

URL of the YouTube video (youtube.com or youtu.be)

​
integrations
string[]

IDs of the integrations to create a draft post for, one draft per clip per integration. Without any, the clips only land in the media library

Maximum array length: 20
​
clips
integer
default:5

Maximum number of clips

Required range: 1 <= x <= 10
​
fit
enum<string>
default:blur

How the horizontal video fills the vertical clip. blur keeps the whole picture over a blurred copy of itself. crop fills the clip with the middle of the picture and cuts the sides away; there is no face tracking

Available options:
blur,
crop

Response

Clipping started

​
id
string

ID of the clipping