POST
/
streaming
/
clips
/
v1

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
project_id
string
required

The ID of the project that owns the clip and the output will be stored.

name
string
required

The name of the clip. It's set to the generated output's name.

playlist_url
string
required

playlist url of the media to be clipped. At the moment, this feature only works with HLS(m3u8) playlists.

trim_in
string

the moment in the source to start the clip based on the source's timeline. if not set, the clip will start at the beginning of the source.

For example if the source is 10 minutes long and trim_in is set to 5 minutes, the clip will start at 5 minutes into the source.

The unit of the value issecond and also the value cannot be negative. for example: 10s, 3s, and so on.

trim_out
string

the moment in the source to end the clip based on the source's timeline. if not set, the clip will end at the end of the source.

For example, if the source is 10 minutes long and trim_out is set to 7 minutes, the clip ends at the 7th minute of the source.

The unit of the value issecond and also the value cannot be negative. for example: 10s, 3s, and so on.

labels
object[]

labels of the clip. labels will be assigned to the output asset.

Response

200 - application/json
clip
object

The created clip.