Update Encoding Profile

Edit an existing transcoding profile.

curl -X POST "https://api.5centscdn.com/v2/transcoding/profiles/7" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "name": "Updated Profile",
  "cv": "libx264",
  "ca": "aac",
  "f": "mp4",
  "filemode": "single",
  "fps": "30",
  "gop": "60",
  "preset": "veryfast",
  "vlevel": "4.1",
  "vprofile": "high",
  "vpass": "1",
  "tune": "film",
  "bv": "1",
  "bvvalue": "4000",
  "ba": "1",
  "bavalue": "128",
  "sv": "720p",
  "svvalue": "1920x800",
  "crfv": "24",
  "ara": "48000",
  "aca": "2",
  "bframe": "2",
  "tm": "interval",
  "tv": "0:01:30",
  "upscale": "N",
  "sourcevideo": "Y",
  "sourceaudio": "Y",
  "hlsUnifiedSegments": false,
  "hlsfMP4Segments": false,
  "outdir": "output/hd",
  "filters": [
    "1"
  ],
  "profiles": [],
  "_METHOD": "DELETE"
}'

import requests
import json

url = "https://api.5centscdn.com/v2/transcoding/profiles/7"
headers = {
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}
data = {
  "name": "Updated Profile",
  "cv": "libx264",
  "ca": "aac",
  "f": "mp4",
  "filemode": "single",
  "fps": "30",
  "gop": "60",
  "preset": "veryfast",
  "vlevel": "4.1",
  "vprofile": "high",
  "vpass": "1",
  "tune": "film",
  "bv": "1",
  "bvvalue": "4000",
  "ba": "1",
  "bavalue": "128",
  "sv": "720p",
  "svvalue": "1920x800",
  "crfv": "24",
  "ara": "48000",
  "aca": "2",
  "bframe": "2",
  "tm": "interval",
  "tv": "0:01:30",
  "upscale": "N",
  "sourcevideo": "Y",
  "sourceaudio": "Y",
  "hlsUnifiedSegments": false,
  "hlsfMP4Segments": false,
  "outdir": "output/hd",
  "filters": [
    "1"
  ],
  "profiles": [],
  "_METHOD": "DELETE"
}

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

const response = await fetch("https://api.5centscdn.com/v2/transcoding/profiles/7", {
  method: "POST",
  headers: {
  "Content-Type": "application/json",
  "X-API-Key": "YOUR_API_KEY"
},
  body: JSON.stringify({
  "name": "Updated Profile",
  "cv": "libx264",
  "ca": "aac",
  "f": "mp4",
  "filemode": "single",
  "fps": "30",
  "gop": "60",
  "preset": "veryfast",
  "vlevel": "4.1",
  "vprofile": "high",
  "vpass": "1",
  "tune": "film",
  "bv": "1",
  "bvvalue": "4000",
  "ba": "1",
  "bavalue": "128",
  "sv": "720p",
  "svvalue": "1920x800",
  "crfv": "24",
  "ara": "48000",
  "aca": "2",
  "bframe": "2",
  "tm": "interval",
  "tv": "0:01:30",
  "upscale": "N",
  "sourcevideo": "Y",
  "sourceaudio": "Y",
  "hlsUnifiedSegments": false,
  "hlsfMP4Segments": false,
  "outdir": "output/hd",
  "filters": [
    "1"
  ],
  "profiles": [],
  "_METHOD": "DELETE"
})
});

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

package main

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

func main() {
    data := []byte(`{
  "name": "Updated Profile",
  "cv": "libx264",
  "ca": "aac",
  "f": "mp4",
  "filemode": "single",
  "fps": "30",
  "gop": "60",
  "preset": "veryfast",
  "vlevel": "4.1",
  "vprofile": "high",
  "vpass": "1",
  "tune": "film",
  "bv": "1",
  "bvvalue": "4000",
  "ba": "1",
  "bavalue": "128",
  "sv": "720p",
  "svvalue": "1920x800",
  "crfv": "24",
  "ara": "48000",
  "aca": "2",
  "bframe": "2",
  "tm": "interval",
  "tv": "0:01:30",
  "upscale": "N",
  "sourcevideo": "Y",
  "sourceaudio": "Y",
  "hlsUnifiedSegments": false,
  "hlsfMP4Segments": false,
  "outdir": "output/hd",
  "filters": [
    "1"
  ],
  "profiles": [],
  "_METHOD": "DELETE"
}`)

    req, err := http.NewRequest("POST", "https://api.5centscdn.com/v2/transcoding/profiles/7", 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/transcoding/profiles/7')
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 = '{
  "name": "Updated Profile",
  "cv": "libx264",
  "ca": "aac",
  "f": "mp4",
  "filemode": "single",
  "fps": "30",
  "gop": "60",
  "preset": "veryfast",
  "vlevel": "4.1",
  "vprofile": "high",
  "vpass": "1",
  "tune": "film",
  "bv": "1",
  "bvvalue": "4000",
  "ba": "1",
  "bavalue": "128",
  "sv": "720p",
  "svvalue": "1920x800",
  "crfv": "24",
  "ara": "48000",
  "aca": "2",
  "bframe": "2",
  "tm": "interval",
  "tv": "0:01:30",
  "upscale": "N",
  "sourcevideo": "Y",
  "sourceaudio": "Y",
  "hlsUnifiedSegments": false,
  "hlsfMP4Segments": false,
  "outdir": "output/hd",
  "filters": [
    "1"
  ],
  "profiles": [],
  "_METHOD": "DELETE"
}'

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

{
  "result": "success",
  "message": "Transcoding Settings Updated"
}

POST

/transcoding/profiles/{profileid}

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)

path

profileidinteger

Required

ID of the Transcode Profile (fs_transcodeprofiles.id).

Content-Typestring

Required

The media type of the request body

Options: application/json

namestring

Profile display name used throughout the encoding UI. Cannot be empty or whitespace only.

cvstring

FFmpeg codec identifier for video encoding. libx264 = H.264/AVC. libx265 = H.265/HEVC. libvpx-vp9 = VP9.

Options: libx264, libx265, libvpx-vp9

castring

Audio codec determined by container format (f). mp4/hls/hlsaes use aac; webm uses opus.

Options: aac, opus

fstring

Output container format. Selecting this auto-populates codec defaults.

Options: mp4, webm, hls, hlsaes

filemodestring

Output file organization. single = one output file per profile. combined = multi-bitrate HLS manifest bundle.

Options: single, combined

fpsstring

Target output frame rate as string. 0 copies the source frame rate.

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

gopstring

Group of Pictures size (frames between keyframes). Smaller values improve seeking accuracy. Typical range 24–300.

presetstring

Encoding speed preset. Slower presets produce smaller files at the cost of encoding time.

Options: ultrafast, superfast, veryfast, faster, fast, medium, slow, slower, veryslow

vlevelstring

Codec encoding level constraining maximum resolution, frame rate, and bitrate. Valid values depend on cv and vprofile.

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

vprofilestring

Codec-specific encoding profile. H.264 (libx264): baseline, main, high. H.265 (libx265): main, main10. VP9 (libvpx-vp9): profile0, profile2. Available values are constrained by cv.

vpassstring

Number of encoding passes. 1 = faster single-pass. 2 = two-pass for more accurate bitrate targeting.

Options: 1, 2

tunestring

H.264 encoding tune preset; only applicable when cv=libx264. disabled = no tune applied.

Options: disabled, film, animation, grain, stillimage, fastdecode

bvstring

Video bitrate mode. 0 = As Source (copies source bitrate). 1 = As Defined (use bvvalue to set target kbps).

Options: 0, 1

bvvaluestring

Target video bitrate in kilobits per second, sent as a string. Required when bv=1.

bastring

Audio bitrate mode. 0 = As Source (copies source bitrate). 1 = As Defined (use bavalue to set target kbps). Forced to 1 when f=webm.

Options: 0, 1

bavaluestring

Target audio bitrate in kilobits per second, sent as a string. Required when ba=1.

svstring

Output resolution. Use as_defined to specify custom dimensions via svvalue. Use 0 to preserve source resolution.

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

svvaluestring

Custom output dimensions as a single WIDTHxHEIGHT string. Only used when sv=as_defined. Both dimensions must be divisible by 2.

crfvstring

Constant Rate Factor for quality-based encoding. Lower value = better quality. Range 0–51; typical H.264 range is 18–28.

arastring

Audio sample rate in Hz. 0 preserves the source sample rate.

Options: 0, 44100, 48000

acastring

Audio output channel count. 0 = As Source. 1 = Mono. 2 = Stereo.

Options: 0, 1, 2

bframestring

Number of consecutive B-frames. Higher values improve compression efficiency.

Options: 0, 1, 2, 3, 4

tmstring

Thumbnail generation mode. interval = generate thumbnails at periodic intervals. fixed = generate thumbnail at exact time tv. disabled = no thumbnails.

Options: interval, fixed, disabled

tvstring

Thumbnail time value in HH:MM:SS format. Required when tm=interval or tm=fixed.

upscalestring

Whether to allow upscaling when the target resolution exceeds the source resolution. Y = allow upscaling. N = skip if source is lower resolution.

Options: Y, N

sourcevideostring

Whether to include the video stream in the output. N = creates audio-only output.

Options: Y, N

sourceaudiostring

Whether to include the audio stream in the output. N = creates video-only output.

Options: Y, N

hlsUnifiedSegmentsboolean

Enables MPEG-TS segment format for HLS output. Defaults to false.

hlsfMP4Segmentsboolean

Enables fragmented MP4 format for HLS output; improves seeking. Mutually exclusive with hlsUnifiedSegments.

outdirstring

Output directory path relative to the storage root. Empty string stores in root. Characters < > : \ | ? * are not allowed.

filtersarray

Array of filter IDs to apply as video overlays during encoding.

profilesarray

Sub-profiles.

_METHODstring

Signal DELETE to the backend when deleting.

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.

Path Parameters

profileidinteger

Required

ID of the Transcode Profile (fs_transcodeprofiles.id).

Example:

7

Body

application/json

namestring

Profile display name used throughout the encoding UI. Cannot be empty or whitespace only.

Example:

Updated Profile

cvstring

FFmpeg codec identifier for video encoding. libx264 = H.264/AVC. libx265 = H.265/HEVC. libvpx-vp9 = VP9.

Allowed values:libx264libx265libvpx-vp9

castring

Audio codec determined by container format (f). mp4/hls/hlsaes use aac; webm uses opus.

Allowed values:aacopus

fstring

Output container format. Selecting this auto-populates codec defaults.

Allowed values:mp4webmhlshlsaes

filemodestring

Output file organization. single = one output file per profile. combined = multi-bitrate HLS manifest bundle.

Allowed values:singlecombined

fpsstring

Target output frame rate as string. 0 copies the source frame rate.

Allowed values:0242530485060

gopstring

Group of Pictures size (frames between keyframes). Smaller values improve seeking accuracy. Typical range 24–300.

Example:

60

presetstring

Encoding speed preset. Slower presets produce smaller files at the cost of encoding time.

Allowed values:ultrafastsuperfastveryfastfasterfastmediumslowslowerveryslow

vlevelstring

Codec encoding level constraining maximum resolution, frame rate, and bitrate. Valid values depend on cv and vprofile.

Allowed values:3.03.13.24.04.14.25.05.15.26.06.16.2

vprofilestring

Codec-specific encoding profile. H.264 (libx264): baseline, main, high. H.265 (libx265): main, main10. VP9 (libvpx-vp9): profile0, profile2. Available values are constrained by cv.

Example:

high

vpassstring

Number of encoding passes. 1 = faster single-pass. 2 = two-pass for more accurate bitrate targeting.

Allowed values:12

tunestring

H.264 encoding tune preset; only applicable when cv=libx264. disabled = no tune applied.

Allowed values:disabledfilmanimationgrainstillimagefastdecode

bvstring

Video bitrate mode. 0 = As Source (copies source bitrate). 1 = As Defined (use bvvalue to set target kbps).

Allowed values:01

bvvaluestring

Target video bitrate in kilobits per second, sent as a string. Required when bv=1.

Example:

4000

bastring

Audio bitrate mode. 0 = As Source (copies source bitrate). 1 = As Defined (use bavalue to set target kbps). Forced to 1 when f=webm.

Allowed values:01

bavaluestring

Target audio bitrate in kilobits per second, sent as a string. Required when ba=1.

Example:

128

svstring

Output resolution. Use as_defined to specify custom dimensions via svvalue. Use 0 to preserve source resolution.

Allowed values:2160p1440p1080p720p576p480p360p240p144p0as_defined

svvaluestring

Custom output dimensions as a single WIDTHxHEIGHT string. Only used when sv=as_defined. Both dimensions must be divisible by 2.

Example:

1920x800

crfvstring

Constant Rate Factor for quality-based encoding. Lower value = better quality. Range 0–51; typical H.264 range is 18–28.

Example:

24

arastring

Audio sample rate in Hz. 0 preserves the source sample rate.

Allowed values:04410048000

acastring

Audio output channel count. 0 = As Source. 1 = Mono. 2 = Stereo.

Allowed values:012

bframestring

Number of consecutive B-frames. Higher values improve compression efficiency.

Allowed values:01234

tmstring

Thumbnail generation mode. interval = generate thumbnails at periodic intervals. fixed = generate thumbnail at exact time tv. disabled = no thumbnails.

Allowed values:intervalfixeddisabled

tvstring

Thumbnail time value in HH:MM:SS format. Required when tm=interval or tm=fixed.

Example:

0:01:30

upscalestring

Whether to allow upscaling when the target resolution exceeds the source resolution. Y = allow upscaling. N = skip if source is lower resolution.

Allowed values:YN

sourcevideostring

Whether to include the video stream in the output. N = creates audio-only output.

Allowed values:YN

sourceaudiostring

Whether to include the audio stream in the output. N = creates video-only output.

Allowed values:YN

hlsUnifiedSegmentsboolean

Enables MPEG-TS segment format for HLS output. Defaults to false.

Example:

false

hlsfMP4Segmentsboolean

Enables fragmented MP4 format for HLS output; improves seeking. Mutually exclusive with hlsUnifiedSegments.

Example:

false

outdirstring

Output directory path relative to the storage root. Empty string stores in root. Characters \< \> : \ | ? * are not allowed.

Example:

output/hd

filtersarray

Array of filter IDs to apply as video overlays during encoding.

Example:

["1"]

profilesarray

Sub-profiles.

Example:

[]

_METHODstring

Signal DELETE to the backend when deleting.

Example:

DELETE

Responses

resultstring

API response status.

messagestring

Human-readable result or error message.

Was this page helpful?

curl -X POST "https://api.5centscdn.com/v2/transcoding/profiles/7" \ -H "Content-Type: application/json" \ -H "X-API-Key: YOUR_API_KEY" \ -d '{ "name": "Updated Profile", "cv": "libx264", "ca": "aac", "f": "mp4", "filemode": "single", "fps": "30", "gop": "60", "preset": "veryfast", "vlevel": "4.1", "vprofile": "high", "vpass": "1", "tune": "film", "bv": "1", "bvvalue": "4000", "ba": "1", "bavalue": "128", "sv": "720p", "svvalue": "1920x800", "crfv": "24", "ara": "48000", "aca": "2", "bframe": "2", "tm": "interval", "tv": "0:01:30", "upscale": "N", "sourcevideo": "Y", "sourceaudio": "Y", "hlsUnifiedSegments": false, "hlsfMP4Segments": false, "outdir": "output/hd", "filters": [ "1" ], "profiles": [], "_METHOD": "DELETE" }'