Get Started
Studio API
- Introduction
- Streaming
- Live Streams
- Simulcasts
- Clips
- Videos
- Video Protection
- Configurations
- Assets
- CMS
- OTT
- Monetization
- IAM
- Integration
- Analytics
Content Delivery API
Deep dive
Create configuration
CreateConfiguration
Creates a new configuration.
curl --request POST \
--url https://api.mottostreaming.com/streaming/configurations/v1 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"project_id": "<string>",
"name": "<string>",
"description": "<string>",
"default": true,
"disabled": true,
"type": "CONFIGURATION_TYPE_UNSPECIFIED",
"data": {
"transcoder_streams": {
"streams": [
{
"video_quality": "VIDEO_QUALITY_UNSPECIFIED",
"video_aspect_ratio": "VIDEO_ASPECT_RATIO_UNSPECIFIED",
"video_bitrate": 123,
"video_framerate": 123,
"video_keyframe_interval": 123,
"segment_duration": 123
}
]
},
"transcoder_overlays": {
"static_overlays": [
{
"asset_id": "<string>",
"x": 123,
"y": 123,
"width": 123,
"height": 123
}
]
},
"automated_tagging": {
"enabled": true
}
}
}'{
"configuration": {
"id": "<string>",
"project_id": "<string>",
"name": "<string>",
"description": "<string>",
"default": true,
"disabled": true,
"type": "CONFIGURATION_TYPE_UNSPECIFIED",
"data": {
"transcoder_streams": {
"streams": [
{
"video_quality": "VIDEO_QUALITY_UNSPECIFIED",
"video_aspect_ratio": "VIDEO_ASPECT_RATIO_UNSPECIFIED",
"video_bitrate": 123,
"video_framerate": 123,
"video_keyframe_interval": 123,
"segment_duration": 123
}
]
},
"transcoder_overlays": {
"static_overlays": [
{
"asset_id": "<string>",
"x": 123,
"y": 123,
"width": 123,
"height": 123
}
]
},
"automated_tagging": {
"enabled": true
}
}
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
The name of the configuration.
The description of the configuration.
Indicates whether this configuration should be applied by default when no configuration is attached to a workflow or simulcast. There can only be one default configuration per type.
Indicates that the configuration should not appear as a selectable option in the UI. This configuration will still be usable by any object it is connected to.
The type of the configuration. This is used to determine which configuration options are available.
CONFIGURATION_TYPE_UNSPECIFIED, CONFIGURATION_TYPE_TRANSCODER_STREAMS, CONFIGURATION_TYPE_TRANSCODER_OVERLAYS, CONFIGURATION_TYPE_AUTOMATED_TAGGING The data for the configuration based on the type.
The configuration is for transcoder streams.
A transcoder can have multiple streams. Each stream will be transcoded separately.
The transcoder stream configuration
The quality of the video stream. Together with the aspect ratio, this will determine the resolution of the transcoded video.
VIDEO_QUALITY_UNSPECIFIED, VIDEO_QUALITY_240P, VIDEO_QUALITY_360P, VIDEO_QUALITY_480P, VIDEO_QUALITY_720P, VIDEO_QUALITY_1080P, VIDEO_QUALITY_1440P, VIDEO_QUALITY_2160P The aspect ratio of the video stream. Together with the quality, this will determine the resolution of the transcoded video.
VIDEO_ASPECT_RATIO_UNSPECIFIED, VIDEO_ASPECT_RATIO_16_9, VIDEO_ASPECT_RATIO_9_16 The bitrate of the video stream in bits per second for the transcoded output. This is the target bitrate, the actual bitrate may vary slightly.
The framerate of the video stream in frames per second for the transcoded output. This is the target framerate, the actual framerate may vary slightly.
The interval between key frames in seconds for the transcoded output. It must not be longer than segment duration. Is it recommended to set this to a divisor of the segment duration (e.g. 2 seconds for a 6-second segment duration).
The output segment size in seconds. Motto currently supports values between 4 and 10 seconds. For low-latency streaming (e.g. LL-HLS), please consult the documentation or contact Motto support.
The configuration is for transcoder overlays (e.g. logos, watermarks).
A list of static image overlays that should be applied to the transcoded video. For dynamic overlays (e.g. scoreboards or moving sponsorship graphics), please consult the documentation or contact Motto support.
The static overlay configuration
The Motto asset ID of the overlay image.
The horizontal position of the overlay as a fraction between 0 and 1, where 0 indicates the left edge of the video, and 1 the right edge.
The vertical position of the overlay as a fraction between 0 and 1, where 0 indicates the top edge of the video, and 1 the bottom edge.
A value between 0 and 1 that indicates the width of the overlay image as a percentage of the video width.
A value between 0 and 1 that indicates the height of the overlay image as a percentage of the video height. If not set while width is known, the aspect ratio of the image will be preserved.
Response
The name of the configuration.
The description of the configuration.
Indicates whether this configuration should be applied by default when no configuration is attached to a workflow or simulcast. There can only be one default configuration per type.
Indicates that the configuration should not appear as a selectable option in the UI. This configuration will still be usable by any object it is connected to.
The type of the configuration. This is used to determine which configuration options are available.
CONFIGURATION_TYPE_UNSPECIFIED, CONFIGURATION_TYPE_TRANSCODER_STREAMS, CONFIGURATION_TYPE_TRANSCODER_OVERLAYS, CONFIGURATION_TYPE_AUTOMATED_TAGGING The data for the configuration based on the type.
The configuration is for transcoder streams.
A transcoder can have multiple streams. Each stream will be transcoded separately.
The transcoder stream configuration
The quality of the video stream. Together with the aspect ratio, this will determine the resolution of the transcoded video.
VIDEO_QUALITY_UNSPECIFIED, VIDEO_QUALITY_240P, VIDEO_QUALITY_360P, VIDEO_QUALITY_480P, VIDEO_QUALITY_720P, VIDEO_QUALITY_1080P, VIDEO_QUALITY_1440P, VIDEO_QUALITY_2160P The aspect ratio of the video stream. Together with the quality, this will determine the resolution of the transcoded video.
VIDEO_ASPECT_RATIO_UNSPECIFIED, VIDEO_ASPECT_RATIO_16_9, VIDEO_ASPECT_RATIO_9_16 The bitrate of the video stream in bits per second for the transcoded output. This is the target bitrate, the actual bitrate may vary slightly.
The framerate of the video stream in frames per second for the transcoded output. This is the target framerate, the actual framerate may vary slightly.
The interval between key frames in seconds for the transcoded output. It must not be longer than segment duration. Is it recommended to set this to a divisor of the segment duration (e.g. 2 seconds for a 6-second segment duration).
The output segment size in seconds. Motto currently supports values between 4 and 10 seconds. For low-latency streaming (e.g. LL-HLS), please consult the documentation or contact Motto support.
The configuration is for transcoder overlays (e.g. logos, watermarks).
A list of static image overlays that should be applied to the transcoded video. For dynamic overlays (e.g. scoreboards or moving sponsorship graphics), please consult the documentation or contact Motto support.
The static overlay configuration
The Motto asset ID of the overlay image.
The horizontal position of the overlay as a fraction between 0 and 1, where 0 indicates the left edge of the video, and 1 the right edge.
The vertical position of the overlay as a fraction between 0 and 1, where 0 indicates the top edge of the video, and 1 the bottom edge.
A value between 0 and 1 that indicates the width of the overlay image as a percentage of the video width.
A value between 0 and 1 that indicates the height of the overlay image as a percentage of the video height. If not set while width is known, the aspect ratio of the image will be preserved.
curl --request POST \
--url https://api.mottostreaming.com/streaming/configurations/v1 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"project_id": "<string>",
"name": "<string>",
"description": "<string>",
"default": true,
"disabled": true,
"type": "CONFIGURATION_TYPE_UNSPECIFIED",
"data": {
"transcoder_streams": {
"streams": [
{
"video_quality": "VIDEO_QUALITY_UNSPECIFIED",
"video_aspect_ratio": "VIDEO_ASPECT_RATIO_UNSPECIFIED",
"video_bitrate": 123,
"video_framerate": 123,
"video_keyframe_interval": 123,
"segment_duration": 123
}
]
},
"transcoder_overlays": {
"static_overlays": [
{
"asset_id": "<string>",
"x": 123,
"y": 123,
"width": 123,
"height": 123
}
]
},
"automated_tagging": {
"enabled": true
}
}
}'{
"configuration": {
"id": "<string>",
"project_id": "<string>",
"name": "<string>",
"description": "<string>",
"default": true,
"disabled": true,
"type": "CONFIGURATION_TYPE_UNSPECIFIED",
"data": {
"transcoder_streams": {
"streams": [
{
"video_quality": "VIDEO_QUALITY_UNSPECIFIED",
"video_aspect_ratio": "VIDEO_ASPECT_RATIO_UNSPECIFIED",
"video_bitrate": 123,
"video_framerate": 123,
"video_keyframe_interval": 123,
"segment_duration": 123
}
]
},
"transcoder_overlays": {
"static_overlays": [
{
"asset_id": "<string>",
"x": 123,
"y": 123,
"width": 123,
"height": 123
}
]
},
"automated_tagging": {
"enabled": true
}
}
}
}