Create Transcoding Profile

add stream profiles setting

curl -X POST "https://api.5centscdn.com/v2/streams/settings/profiles/new" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "_METHOD": "PUT",
  "name": "My 720p Profile",
  "filemode": "sd",
  "f": "mp4",
  "cv": "libx264",
  "sv": "720p",
  "svvalue": "",
  "svwidth": "",
  "svheight": "",
  "deinterlace": "0",
  "bvvalue": "2000",
  "fps": "24",
  "preset": "faster",
  "vprofile": "main",
  "vlevel": "3.1",
  "bframe": "0",
  "gop": "10",
  "tune": "disabled",
  "crf": "ll",
  "ca": "aac",
  "aca": "1",
  "bavalue": "80",
  "ara": "44100"
}'

import requests
import json

url = "https://api.5centscdn.com/v2/streams/settings/profiles/new"
headers = {
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}
data = {
  "_METHOD": "PUT",
  "name": "My 720p Profile",
  "filemode": "sd",
  "f": "mp4",
  "cv": "libx264",
  "sv": "720p",
  "svvalue": "",
  "svwidth": "",
  "svheight": "",
  "deinterlace": "0",
  "bvvalue": "2000",
  "fps": "24",
  "preset": "faster",
  "vprofile": "main",
  "vlevel": "3.1",
  "bframe": "0",
  "gop": "10",
  "tune": "disabled",
  "crf": "ll",
  "ca": "aac",
  "aca": "1",
  "bavalue": "80",
  "ara": "44100"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch("https://api.5centscdn.com/v2/streams/settings/profiles/new", {
  method: "POST",
  headers: {
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
},
  body: JSON.stringify({
  "_METHOD": "PUT",
  "name": "My 720p Profile",
  "filemode": "sd",
  "f": "mp4",
  "cv": "libx264",
  "sv": "720p",
  "svvalue": "",
  "svwidth": "",
  "svheight": "",
  "deinterlace": "0",
  "bvvalue": "2000",
  "fps": "24",
  "preset": "faster",
  "vprofile": "main",
  "vlevel": "3.1",
  "bframe": "0",
  "gop": "10",
  "tune": "disabled",
  "crf": "ll",
  "ca": "aac",
  "aca": "1",
  "bavalue": "80",
  "ara": "44100"
})
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    data := []byte(`{
  "_METHOD": "PUT",
  "name": "My 720p Profile",
  "filemode": "sd",
  "f": "mp4",
  "cv": "libx264",
  "sv": "720p",
  "svvalue": "",
  "svwidth": "",
  "svheight": "",
  "deinterlace": "0",
  "bvvalue": "2000",
  "fps": "24",
  "preset": "faster",
  "vprofile": "main",
  "vlevel": "3.1",
  "bframe": "0",
  "gop": "10",
  "tune": "disabled",
  "crf": "ll",
  "ca": "aac",
  "aca": "1",
  "bavalue": "80",
  "ara": "44100"
}`)

    req, err := http.NewRequest("POST", "https://api.5centscdn.com/v2/streams/settings/profiles/new", bytes.NewBuffer(data))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", "YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://api.5centscdn.com/v2/streams/settings/profiles/new')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['X-API-Key'] = 'YOUR_API_KEY'
request.body = '{
  "_METHOD": "PUT",
  "name": "My 720p Profile",
  "filemode": "sd",
  "f": "mp4",
  "cv": "libx264",
  "sv": "720p",
  "svvalue": "",
  "svwidth": "",
  "svheight": "",
  "deinterlace": "0",
  "bvvalue": "2000",
  "fps": "24",
  "preset": "faster",
  "vprofile": "main",
  "vlevel": "3.1",
  "bframe": "0",
  "gop": "10",
  "tune": "disabled",
  "crf": "ll",
  "ca": "aac",
  "aca": "1",
  "bavalue": "80",
  "ara": "44100"
}'

response = http.request(request)
puts response.body

{
  "result": "success",
  "message": "Transcoding Settings, New Profile Created",
  "profileid": 129699
}

POST

/streams/settings/profiles/new

POST

Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)

X-API-Keystring

Required

API key (sent in header)

Content-Typestring

Required

The media type of the request body

Options: application/json

_METHODstring

Required

HTTP method override for this request. Always set to PUT to perform a create operation.

namestring

Required

Name of the transcoding profile. Required; must not be empty.

filemodestring

Required

Stream quality tier. Required. Defaults to sd.

Options: sd, hd, uhd

fstring

Required

Container format for the output stream. Currently only mp4 is supported. Required. Defaults to mp4.

Options: mp4

cvstring

Required

Video codec. libx264 = H.264, libx265 = H.265. Only these two codecs are currently supported. Required. Defaults to libx264. Selecting libx265 restricts vprofile to main and tune to disabled/fastdecode (see those fields). Unlike the Update endpoint, this endpoint does not cross-validate resolution, bitrate, and FPS against the selected codec/profile/level.

Options: libx264, libx265

svstring

Required

Output resolution preset. Select as_defined to specify a custom resolution via svvalue/svwidth/svheight. Defaults to 720p.

Options: 2160p, 1440p, 1080p, 720p, 576p, 480p, 360p, 240p, 144p, as_defined

svvaluestring

Custom resolution in WIDTHxHEIGHT format (e.g. 1920x1080), used when sv is as_defined. Optional; unlike the Update endpoint, this endpoint does not enforce the numeric/divisible-by-2 or 256-7680 / 144-4320 range rules. Empty string when sv is a fixed preset.

svwidthstring

Width component of the custom resolution, used only when sv is as_defined. Optional; not combined into or validated against svvalue on this endpoint.

svheightstring

Height component of the custom resolution, used only when sv is as_defined. Optional; not combined into or validated against svvalue on this endpoint.

deinterlacestring

Required

Deinterlacing toggle. 1 = Yes (enabled), 0 = No (disabled). Defaults to 0.

Options: 0, 1

bvvaluestring

Required

Video bitrate in kbps. Required. Defaults to 2000. Unlike the Update endpoint, no minimum value is enforced here.

fpsstring

Required

Frames per second. 0 means As Source. Required. Defaults to 24. Unlike the Update endpoint, the 48, 50, and 60 values are not restricted to higher encoding levels here.

Options: 0, 24, 25, 30, 48, 50, 60

presetstring

Required

Encoding speed preset. Required. Defaults to faster.

Options: superfast, veryfast, faster, fast

vprofilestring

Required

Video encoding profile. Required. Defaults to main. When cv is libx264, all three options are valid; when cv is libx265, only main is valid. Selecting a profile sets vlevel to a corresponding default value: baseline -> 3.0, high -> 4.0, main -> 3.1.

Options: baseline, main, high

vlevelstring

Encoding level. Optional; automatically set based on vprofile (see vprofile). Defaults to 3.1. Unlike the Update endpoint, this endpoint does not cross-check vlevel against cv/vprofile-specific resolution, bitrate, or FPS ceilings.

Options: 3.0, 3.1, 3.2, 4.0, 4.1, 4.2, 5.0, 5.1, 5.2

bframestring

Required

Number of consecutive B-frames used in encoding. This value is not currently configurable and is always submitted as 0.

gopstring

Required

Group of Pictures (keyframe) interval in seconds. Required. Defaults to 10.

Options: 2, 4, 6, 8, 10, 12

tunestring

Encoding tune. Optional. Defaults to disabled. Available options depend on cv: libx264 allows disabled, zerolatency, fastdecode; libx265 allows disabled, fastdecode only. Unlike the Update endpoint, this endpoint does not require the Advanced Features add-on to select zerolatency or fastdecode.

Options: disabled, zerolatency, fastdecode

crfstring

Internal CRF quality flag. Not currently configurable; always submitted with the default value ll.

castring

Required

Audio codec. Only aac is currently offered. Required. Defaults to aac.

Options: aac

acastring

Required

Audio channel configuration. 0 = As Source, 1 = Stereo, 2 = Mono. Required. Defaults to 1 (Stereo).

Options: 0, 1, 2

bavaluestring

Required

Audio bitrate in kbps. Required. Defaults to 80. Unlike the Update endpoint, no minimum or maximum value is enforced here.

arastring

Required

Audio sample rate in Hz. Required. Defaults to 44100.

Options: 48000, 44100, 32000, 22050, 16000

Request Preview

Response

Response will appear here after sending the request

Authentication

header

X-API-Keystring

Required

API Key for authentication. Provide your API key in the header.

Body

application/json

_METHODstring

Required

HTTP method override for this request. Always set to PUT to perform a create operation.

Example:

PUT

namestring

Required

Name of the transcoding profile. Required; must not be empty.

Example:

My 720p Profile

filemodestring

Required

Stream quality tier. Required. Defaults to sd.

Allowed values:sdhduhd

fstring

Required

Container format for the output stream. Currently only mp4 is supported. Required. Defaults to mp4.

Allowed values:mp4

cvstring

Required

Allowed values:libx264libx265

svstring

Required

Output resolution preset. Select as_defined to specify a custom resolution via svvalue/svwidth/svheight. Defaults to 720p.

Allowed values:2160p1440p1080p720p576p480p360p240p144pas_defined

svvaluestring

Example:

svwidthstring

Width component of the custom resolution, used only when sv is as_defined. Optional; not combined into or validated against svvalue on this endpoint.

Example:

svheightstring

Height component of the custom resolution, used only when sv is as_defined. Optional; not combined into or validated against svvalue on this endpoint.

Example:

deinterlacestring

Required

Deinterlacing toggle. 1 = Yes (enabled), 0 = No (disabled). Defaults to 0.

Allowed values:01

bvvaluestring

Required

Video bitrate in kbps. Required. Defaults to 2000. Unlike the Update endpoint, no minimum value is enforced here.

Example:

2000

fpsstring

Required

Frames per second. 0 means As Source. Required. Defaults to 24. Unlike the Update endpoint, the 48, 50, and 60 values are not restricted to higher encoding levels here.

Allowed values:0242530485060

presetstring

Required

Encoding speed preset. Required. Defaults to faster.

Allowed values:superfastveryfastfasterfast

vprofilestring

Required

Allowed values:baselinemainhigh

vlevelstring

Allowed values:3.03.13.24.04.14.25.05.15.2

bframestring

Required

Number of consecutive B-frames used in encoding. This value is not currently configurable and is always submitted as 0.

Example:

0

gopstring

Required

Group of Pictures (keyframe) interval in seconds. Required. Defaults to 10.

Allowed values:24681012

tunestring

Allowed values:disabledzerolatencyfastdecode

crfstring

Internal CRF quality flag. Not currently configurable; always submitted with the default value ll.

Example:

ll

castring

Required

Audio codec. Only aac is currently offered. Required. Defaults to aac.

Allowed values:aac

acastring

Required

Audio channel configuration. 0 = As Source, 1 = Stereo, 2 = Mono. Required. Defaults to 1 (Stereo).

Allowed values:012

bavaluestring

Required

Audio bitrate in kbps. Required. Defaults to 80. Unlike the Update endpoint, no minimum or maximum value is enforced here.

Example:

80

arastring

Required

Audio sample rate in Hz. Required. Defaults to 44100.

Allowed values:4800044100320002205016000

Responses

resultstring

Status of the API response.

messagestring

Human-readable message describing the result.

profileidinteger

The ID of the newly created transcoding profile.

Was this page helpful?

curl -X POST "https://api.5centscdn.com/v2/streams/settings/profiles/new" \ -H "Content-Type: application/json" \ -H "X-API-Key: YOUR_API_KEY" \ -d '{ "_METHOD": "PUT", "name": "My 720p Profile", "filemode": "sd", "f": "mp4", "cv": "libx264", "sv": "720p", "svvalue": "", "svwidth": "", "svheight": "", "deinterlace": "0", "bvvalue": "2000", "fps": "24", "preset": "faster", "vprofile": "main", "vlevel": "3.1", "bframe": "0", "gop": "10", "tune": "disabled", "crf": "ll", "ca": "aac", "aca": "1", "bavalue": "80", "ara": "44100" }'