Streamio API Documentation

Encoding Profiles - Create

Create a encoding profile on your account with the specified parameters. Don't forget to specify POST as the request method as GET will call the list action rather than create.

Request

Url

https://streamio.com/api/v1/encoding_profiles.format

Request Method

POST

Parameters

  • title The title of the encoding profile.
  • tags The tags you wish to set for the encoding profile. Multiple tags are separated by comma.
  • width Desired width of the encoded video in pixels. Note that height will be determined automatically based on the aspect ratio of the video being encoded.
  • desired_video_bitrate The bitrate you wish to use for the video stream in kilobits. Note that some sensible variable bitrate will be added to this value meaning this is not a constant value.
  • frame_rate Number of frames per second. If none is specified encoding will be done at the same frame rate as the uploaded video.
  • audio_bitrate Bitrate of the audio stream in kilobits. Valid values are 16, 32, 64, 80, 96, 128, 160, 192, 224, 256, 288 and 320. Default is 128.
  • audio_sample_rate The sample rate for the audio stream. Valid values are 11025, 16000, 22050, 44100 and 48000. Default is 44100.
  • audio_channels Number of audio channels. Valid values are 1 (for mono) and 2 (for stereo). Default is 2.

Response

Code

201

Body

Examples

A simple create

Here's an example of creating a low bitrate (around 300k) profile.

curl -u username:password \
     -F title=Low \
     -F width=320 \
     -F desired_video_bitrate=250 \
     -F frame_rate=15 \
     -F audio_bitrate=48 \
     -F audio_sample_rate=22050 \
     -F audio_channels=1 \
     https://streamio.com/api/v1/encoding_profiles.json