Skip to main content
POST
/
streaming
/
clips
/
v1
cURL
curl --request POST \
  --url https://api.mottostreaming.com/streaming/clips/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "project_id": "<string>",
  "name": "<string>",
  "trim_in": "<string>",
  "trim_out": "<string>",
  "labels": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ]
}'
{
  "clip": {
    "id": "<string>",
    "project_id": "<string>",
    "name": "<string>",
    "playlist_url": {
      "playlist_url": "<string>",
      "bearer_token": "<string>"
    },
    "asset_id": "<string>",
    "reserved_asset_id": "<string>",
    "trim_in": "<string>",
    "trim_out": "<string>",
    "state": "STATE_UNSPECIFIED",
    "labels": [
      {
        "key": "<string>",
        "value": "<string>"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json

CreateClipRequest is the request message for CreateClip.

​
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.

​
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

OK

CreateClipResponse is the response message for CreateClip.

​
clip
object

The created clip.

⌘I