Create a new video processing job with specified parameters. The job is created with pending status and waits for scheduler admission before processing. Pending jobs are admitted oldest first across all projects in the team as vCPU capacity becomes available.
POST
/api/jobs
Authorization
Authorization
header
string
required
Enter the project access token with the Bearer prefix, e.g. "Bearer project_access_token"
Bodyapplication/json
Job creation parameters
format
object
required
Required format configuration, one and only one valid format configuration must be provided.
If you want to use a format without specifying any configuration, use an empty object in the corresponding field.
FFmpeg encoding parameters specific to MP4 with AV1 encoding.
id
"mp4_av1"
string
required
audio_bitrate
integer
AudioBitrate specifies the audio bitrate in bits per second.
Must be between 32Kbps and 512Kbps.
Required range: 32000 <= x <= 512000
bufsize
integer
Bufsize specifies the video buffer size in bits.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
channels
integer
Channels specifies the number of audio channels.
Valid values: 1 (mono), 2 (stereo), 5 (5.1), 7 (7.1)
Available options:
1257
crf
default: 35
integer
Crf (Constant Rate Factor) controls the quality of the output video.
Lower values mean better quality but larger file size. Range: 16 to 63.
Recommended values: 16-35 for high quality, 35-45 for good quality, 45-63 for acceptable quality.
Required range: 16 <= x <= 63
Examples:
35
disable_audio
boolean
DisableAudio indicates whether to disable audio processing.
disable_video
boolean
DisableVideo indicates whether to disable video processing.
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
framerate
number
Framerate specifies the output video frame rate.
Must be between 15 and 120 fps.
Required range: 15 <= x <= 120
gop
integer
Gop specifies the Group of Pictures (GOP) size.
Must be between 1 and 300.
Required range: 1 <= x <= 300
height
integer
Height specifies the output video height in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
level
integer
Level specifies the AV1 profile level. Valid values: 30-31 (main), 41 (main10).
Higher levels support higher resolutions and bitrates but require more processing power.
Available options:
303141
Examples:
41
maxrate
integer
Maxrate specifies the maximum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate specifies the minimum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
movflags
string
per_title
default: false
boolean
Enables per-title optimization. Disabled by default. Set it to true to let Chunkify select rate control automatically. When enabled, explicit rate-control fields cannot be provided. For HLS outputs, either audio_bitrate or video_bitrate is required when per-title optimization is disabled or omitted.
pixfmt
default: "yuv420p"
string
PixFmt specifies the pixel format.
Valid value: yuv420p
Preset controls the encoding efficiency and processing intensity. Lower presets use more
optimization features, creating smaller files with better quality but requiring more compute time.
Higher presets encode faster but produce larger files.
Preset ranges:
6-7: Fast encoding for real-time applications (smaller files)
8-10: Balanced efficiency and speed for general use
11-13: Fastest encoding for real-time applications (larger files)
Available options:
678910111213
Examples:
10
profilev
string
Profilev specifies the AV1 profile. Valid values:
main: Main profile, good for most applications
main10: Main 10-bit profile, supports 10-bit color
mainstillpicture: Still picture profile, optimized for single images
Available options:
mainmain10mainstillpicture
Examples:
main10
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
video_bitrate
integer
VideoBitrate specifies the video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
width
integer
Width specifies the output video width in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
FFmpeg encoding parameters specific to MP4 with H.264 encoding.
id
"mp4_h264"
string
required
audio_bitrate
integer
AudioBitrate specifies the audio bitrate in bits per second.
Must be between 32Kbps and 512Kbps.
Required range: 32000 <= x <= 512000
bufsize
integer
Bufsize specifies the video buffer size in bits.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
channels
integer
Channels specifies the number of audio channels.
Valid values: 1 (mono), 2 (stereo), 5 (5.1), 7 (7.1)
Available options:
1257
crf
default: 21
integer
Crf (Constant Rate Factor) controls the quality of the output video.
Lower values mean better quality but larger file size. Range: 16 to 35.
Recommended values: 18-28 for high quality, 23-28 for good quality, 28-35 for acceptable quality.
Required range: 16 <= x <= 35
Examples:
23
disable_audio
boolean
DisableAudio indicates whether to disable audio processing.
disable_video
boolean
DisableVideo indicates whether to disable video processing.
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
framerate
number
Framerate specifies the output video frame rate.
Must be between 15 and 120 fps.
Required range: 15 <= x <= 120
gop
integer
Gop specifies the Group of Pictures (GOP) size.
Must be between 1 and 300.
Required range: 1 <= x <= 300
height
integer
Height specifies the output video height in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
level
integer
Level specifies the H.264 profile level. Valid values: 10-13 (baseline), 20-22 (main), 30-32 (high), 40-42 (high), 50-51 (high).
Higher levels support higher resolutions and bitrates but require more processing power.
Available options:
101112132021223031324041425051
Examples:
41
maxrate
integer
Maxrate specifies the maximum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate specifies the minimum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
movflags
string
per_title
default: false
boolean
Enables per-title optimization. Disabled by default. Set it to true to let Chunkify select rate control automatically. When enabled, explicit rate-control fields cannot be provided. For HLS outputs, either audio_bitrate or video_bitrate is required when per-title optimization is disabled or omitted.
pixfmt
default: "yuv420p"
string
PixFmt specifies the pixel format.
Valid value: yuv420p
Preset specifies the encoding speed preset. Valid values (from fastest to slowest):
ultrafast: Fastest encoding, lowest quality
superfast: Very fast encoding, lower quality
veryfast: Fast encoding, moderate quality
faster: Faster encoding, good quality
fast: Fast encoding, better quality
medium: Balanced preset, best quality
Available options:
ultrafastsuperfastveryfastfasterfastmedium
Examples:
medium
profilev
string
Profilev specifies the H.264 profile. Valid values:
baseline: Basic profile, good for mobile devices
main: Main profile, good for most applications
high: High profile, best quality but requires more processing
high10: High 10-bit profile, supports 10-bit color
high422: High 4:2:2 profile, supports 4:2:2 color sampling
high444: High 4:4:4 profile, supports 4:4:4 color sampling
Available options:
baselinemainhighhigh10high422high444
Examples:
high
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
video_bitrate
integer
VideoBitrate specifies the video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
width
integer
Width specifies the output video width in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
x264_keyint
integer
X264KeyInt specifies the maximum number of frames between keyframes for H.264 encoding.
Range: 1 to 300. Higher values can improve compression but may affect seeking.
Required range: 1 <= x <= 300
Examples:
60
FFmpeg encoding parameters specific to MP4 with H.265 encoding.
id
"mp4_h265"
string
required
audio_bitrate
integer
AudioBitrate specifies the audio bitrate in bits per second.
Must be between 32Kbps and 512Kbps.
Required range: 32000 <= x <= 512000
bufsize
integer
Bufsize specifies the video buffer size in bits.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
channels
integer
Channels specifies the number of audio channels.
Valid values: 1 (mono), 2 (stereo), 5 (5.1), 7 (7.1)
Available options:
1257
crf
default: 24
integer
Crf (Constant Rate Factor) controls the quality of the output video.
Lower values mean better quality but larger file size. Range: 16 to 35.
Recommended values: 18-28 for high quality, 23-28 for good quality, 28-35 for acceptable quality.
Required range: 16 <= x <= 35
Examples:
23
disable_audio
boolean
DisableAudio indicates whether to disable audio processing.
disable_video
boolean
DisableVideo indicates whether to disable video processing.
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
framerate
number
Framerate specifies the output video frame rate.
Must be between 15 and 120 fps.
Required range: 15 <= x <= 120
gop
integer
Gop specifies the Group of Pictures (GOP) size.
Must be between 1 and 300.
Required range: 1 <= x <= 300
height
integer
Height specifies the output video height in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
level
integer
Level specifies the H.265 profile level. Valid values: 30-31 (main), 41 (main10).
Higher levels support higher resolutions and bitrates but require more processing power.
Available options:
303141
Examples:
41
maxrate
integer
Maxrate specifies the maximum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate specifies the minimum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
movflags
string
per_title
default: false
boolean
Enables per-title optimization. Disabled by default. Set it to true to let Chunkify select rate control automatically. When enabled, explicit rate-control fields cannot be provided. For HLS outputs, either audio_bitrate or video_bitrate is required when per-title optimization is disabled or omitted.
pixfmt
default: "yuv420p"
string
PixFmt specifies the pixel format.
Valid value: yuv420p
Preset specifies the encoding speed preset. Valid values (from fastest to slowest):
ultrafast: Fastest encoding, lowest quality
superfast: Very fast encoding, lower quality
veryfast: Fast encoding, moderate quality
faster: Faster encoding, good quality
fast: Fast encoding, better quality
medium: Balanced preset, best quality
Available options:
ultrafastsuperfastveryfastfasterfastmedium
Examples:
medium
profilev
string
Profilev specifies the H.265 profile. Valid values:
main: Main profile, good for most applications
main10: Main 10-bit profile, supports 10-bit color
mainstillpicture: Still picture profile, optimized for single images
Available options:
mainmain10mainstillpicture
Examples:
main10
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
video_bitrate
integer
VideoBitrate specifies the video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
width
integer
Width specifies the output video width in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
x265_keyint
integer
X265KeyInt specifies the maximum number of frames between keyframes for H.265 encoding.
Range: 1 to 300. Higher values can improve compression but may affect seeking.
Required range: 1 <= x <= 300
Examples:
60
FFmpeg encoding parameters specific to WebM with VP9 encoding.
id
"webm_vp9"
string
required
audio_bitrate
integer
AudioBitrate specifies the audio bitrate in bits per second.
Must be between 32Kbps and 512Kbps.
Required range: 32000 <= x <= 512000
bufsize
integer
Bufsize specifies the video buffer size in bits.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
channels
integer
Channels specifies the number of audio channels.
Valid values: 1 (mono), 2 (stereo), 5 (5.1), 7 (7.1)
Available options:
1257
cpu_used
default: "5"
string
CpuUsed specifies the CPU usage level for VP9 encoding. Range: 0 to 8.
Lower values mean better quality but slower encoding, higher values mean faster encoding but lower quality.
Recommended values: 0-2 for high quality, 2-4 for good quality, 4-6 for balanced, 6-8 for speed
Available options:
012345678
Examples:
4
crf
default: 24
integer
Crf (Constant Rate Factor) controls the quality of the output video.
Lower values mean better quality but larger file size. Range: 15 to 35.
Recommended values: 18-28 for high quality, 23-28 for good quality, 28-35 for acceptable quality.
Required range: 15 <= x <= 35
Examples:
23
disable_audio
boolean
DisableAudio indicates whether to disable audio processing.
disable_video
boolean
DisableVideo indicates whether to disable video processing.
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
framerate
number
Framerate specifies the output video frame rate.
Must be between 15 and 120 fps.
Required range: 15 <= x <= 120
gop
integer
Gop specifies the Group of Pictures (GOP) size.
Must be between 1 and 300.
Required range: 1 <= x <= 300
height
integer
Height specifies the output video height in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
maxrate
integer
Maxrate specifies the maximum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate specifies the minimum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
per_title
default: false
boolean
Enables per-title optimization. Disabled by default. Set it to true to let Chunkify select rate control automatically. When enabled, explicit rate-control fields cannot be provided. For HLS outputs, either audio_bitrate or video_bitrate is required when per-title optimization is disabled or omitted.
pixfmt
default: "yuv420p"
string
PixFmt specifies the pixel format.
Valid value: yuv420p
Quality specifies the VP9 encoding quality preset. Valid values:
good: Balanced quality preset, good for most applications
best: Best quality preset, slower encoding
realtime: Fast encoding preset, suitable for live streaming
Available options:
goodbestrealtime
Examples:
good
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
video_bitrate
integer
VideoBitrate specifies the video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
width
integer
Width specifies the output video width in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
FFmpeg encoding parameters specific to HLS with AV1 encoding. When per-title optimization is disabled, either audio_bitrate or video_bitrate is required.
id
"hls_av1"
string
required
audio_bitrate
integer
AudioBitrate specifies the audio bitrate in bits per second.
Must be between 32Kbps and 512Kbps.
Required range: 32000 <= x <= 512000
bufsize
integer
Bufsize specifies the video buffer size in bits.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
channels
integer
Channels specifies the number of audio channels.
Valid values: 1 (mono), 2 (stereo), 5 (5.1), 7 (7.1)
Available options:
1257
crf
default: 35
integer
Crf (Constant Rate Factor) controls the quality of the output video.
Lower values mean better quality but larger file size. Range: 16 to 63.
Recommended values: 16-35 for high quality, 35-45 for good quality, 45-63 for acceptable quality.
Required range: 16 <= x <= 63
Examples:
35
disable_audio
boolean
DisableAudio indicates whether to disable audio processing.
disable_video
boolean
DisableVideo indicates whether to disable video processing.
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
framerate
number
Framerate specifies the output video frame rate.
Must be between 15 and 120 fps.
Required range: 15 <= x <= 120
gop
integer
Gop specifies the Group of Pictures (GOP) size.
Must be between 1 and 300.
Required range: 1 <= x <= 300
height
integer
Height specifies the output video height in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
hls_enc
boolean
HlsEnc enables encryption for HLS segments when set to true.
Examples:
false
hls_enc_iv
string
HlsEncIv specifies the initialization vector for encryption. Maximum length: 64 characters.
Required when HlsEnc is true.
Examples:
0123456789abcdef
hls_enc_key
string
HlsEncKey specifies the encryption key for HLS segments. Maximum length: 64 characters.
Required when HlsEnc is true.
Examples:
0123456789abcdef
hls_enc_key_url
string
HlsEncKeyUrl specifies the URL where clients can fetch the encryption key.
Required when HlsEnc is true.
Examples:
https://example.com/key
hls_segment_type
default: "fmp4"
string
HlsSegmentType specifies the type of HLS segments. Valid values:
mpegts: Traditional MPEG-TS segments, better compatibility
fmp4: Fragmented MP4 segments, better efficiency
Available options:
mpegtsfmp4
Examples:
mpegts
hls_time
default: 4
integer
HlsTime specifies the duration of each HLS segment in seconds. Range: 1 to 10.
Shorter segments provide faster startup but more overhead, longer segments are more efficient.
Required range: 1 <= x <= 10
Examples:
6
level
integer
Level specifies the AV1 profile level. Valid values: 30-31 (main), 41 (main10).
Higher levels support higher resolutions and bitrates but require more processing power.
Available options:
303141
Examples:
41
maxrate
integer
Maxrate specifies the maximum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate specifies the minimum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
movflags
string
per_title
default: false
boolean
Enables per-title optimization. Disabled by default. Set it to true to let Chunkify select rate control automatically. When enabled, explicit rate-control fields cannot be provided. For HLS outputs, either audio_bitrate or video_bitrate is required when per-title optimization is disabled or omitted.
pixfmt
default: "yuv420p"
string
PixFmt specifies the pixel format.
Valid value: yuv420p
Preset controls the encoding efficiency and processing intensity. Lower presets use more
optimization features, creating smaller files with better quality but requiring more compute time.
Higher presets encode faster but produce larger files.
Preset ranges:
6-7: Fast encoding for real-time applications (smaller files)
8-10: Balanced efficiency and speed for general use
11-13: Fastest encoding for real-time applications (larger files)
Available options:
678910111213
Examples:
10
profilev
string
Profilev specifies the AV1 profile. Valid values:
main: Main profile, good for most applications
main10: Main 10-bit profile, supports 10-bit color
mainstillpicture: Still picture profile, optimized for single images
Available options:
mainmain10mainstillpicture
Examples:
main10
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
video_bitrate
integer
VideoBitrate specifies the video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
width
integer
Width specifies the output video width in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
FFmpeg encoding parameters specific to HLS with H.264 encoding. When per-title optimization is disabled, either audio_bitrate or video_bitrate is required.
id
"hls_h264"
string
required
audio_bitrate
integer
AudioBitrate specifies the audio bitrate in bits per second.
Must be between 32Kbps and 512Kbps.
Required range: 32000 <= x <= 512000
bufsize
integer
Bufsize specifies the video buffer size in bits.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
channels
integer
Channels specifies the number of audio channels.
Valid values: 1 (mono), 2 (stereo), 5 (5.1), 7 (7.1)
Available options:
1257
crf
default: 21
integer
Crf (Constant Rate Factor) controls the quality of the output video.
Lower values mean better quality but larger file size. Range: 16 to 35.
Recommended values: 18-28 for high quality, 23-28 for good quality, 28-35 for acceptable quality.
Required range: 16 <= x <= 35
Examples:
23
disable_audio
boolean
DisableAudio indicates whether to disable audio processing.
disable_video
boolean
DisableVideo indicates whether to disable video processing.
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
framerate
number
Framerate specifies the output video frame rate.
Must be between 15 and 120 fps.
Required range: 15 <= x <= 120
gop
integer
Gop specifies the Group of Pictures (GOP) size.
Must be between 1 and 300.
Required range: 1 <= x <= 300
height
integer
Height specifies the output video height in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
hls_enc
boolean
HlsEnc enables encryption for HLS segments when set to true.
Examples:
false
hls_enc_iv
string
HlsEncIv specifies the initialization vector for encryption. Maximum length: 64 characters.
Required when HlsEnc is true.
Examples:
0123456789abcdef
hls_enc_key
string
HlsEncKey specifies the encryption key for HLS segments. Maximum length: 64 characters.
Required when HlsEnc is true.
Examples:
0123456789abcdef
hls_enc_key_url
string
HlsEncKeyUrl specifies the URL where clients can fetch the encryption key.
Required when HlsEnc is true.
Examples:
https://example.com/key
hls_segment_type
default: "fmp4"
string
HlsSegmentType specifies the type of HLS segments. Valid values:
mpegts: Traditional MPEG-TS segments, better compatibility
fmp4: Fragmented MP4 segments, better efficiency
Available options:
mpegtsfmp4
Examples:
mpegts
hls_time
default: 4
integer
HlsTime specifies the duration of each HLS segment in seconds. Range: 1 to 10.
Shorter segments provide faster startup but more overhead, longer segments are more efficient.
Required range: 1 <= x <= 10
Examples:
6
level
integer
Level specifies the H.264 profile level. Valid values: 10-13 (baseline), 20-22 (main), 30-32 (high), 40-42 (high), 50-51 (high).
Higher levels support higher resolutions and bitrates but require more processing power.
Available options:
101112132021223031324041425051
Examples:
41
maxrate
integer
Maxrate specifies the maximum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate specifies the minimum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
movflags
string
per_title
default: false
boolean
Enables per-title optimization. Disabled by default. Set it to true to let Chunkify select rate control automatically. When enabled, explicit rate-control fields cannot be provided. For HLS outputs, either audio_bitrate or video_bitrate is required when per-title optimization is disabled or omitted.
pixfmt
default: "yuv420p"
string
PixFmt specifies the pixel format.
Valid value: yuv420p
Preset specifies the encoding speed preset. Valid values (from fastest to slowest):
ultrafast: Fastest encoding, lowest quality
superfast: Very fast encoding, lower quality
veryfast: Fast encoding, moderate quality
faster: Faster encoding, good quality
fast: Fast encoding, better quality
medium: Balanced preset, best quality
Available options:
ultrafastsuperfastveryfastfasterfastmedium
Examples:
medium
profilev
string
Profilev specifies the H.264 profile. Valid values:
baseline: Basic profile, good for mobile devices
main: Main profile, good for most applications
high: High profile, best quality but requires more processing
high10: High 10-bit profile, supports 10-bit color
high422: High 4:2:2 profile, supports 4:2:2 color sampling
high444: High 4:4:4 profile, supports 4:4:4 color sampling
Available options:
baselinemainhighhigh10high422high444
Examples:
high
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
video_bitrate
integer
VideoBitrate specifies the video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
width
integer
Width specifies the output video width in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
x264_keyint
integer
X264KeyInt specifies the maximum number of frames between keyframes for H.264 encoding.
Range: 1 to 300. Higher values can improve compression but may affect seeking.
Required range: 1 <= x <= 300
Examples:
60
FFmpeg encoding parameters specific to HLS with H.265 encoding. When per-title optimization is disabled, either audio_bitrate or video_bitrate is required.
id
"hls_h265"
string
required
audio_bitrate
integer
AudioBitrate specifies the audio bitrate in bits per second.
Must be between 32Kbps and 512Kbps.
Required range: 32000 <= x <= 512000
bufsize
integer
Bufsize specifies the video buffer size in bits.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
channels
integer
Channels specifies the number of audio channels.
Valid values: 1 (mono), 2 (stereo), 5 (5.1), 7 (7.1)
Available options:
1257
crf
default: 24
integer
Crf (Constant Rate Factor) controls the quality of the output video.
Lower values mean better quality but larger file size. Range: 16 to 35.
Recommended values: 18-28 for high quality, 23-28 for good quality, 28-35 for acceptable quality.
Required range: 16 <= x <= 35
Examples:
23
disable_audio
boolean
DisableAudio indicates whether to disable audio processing.
disable_video
boolean
DisableVideo indicates whether to disable video processing.
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
framerate
number
Framerate specifies the output video frame rate.
Must be between 15 and 120 fps.
Required range: 15 <= x <= 120
gop
integer
Gop specifies the Group of Pictures (GOP) size.
Must be between 1 and 300.
Required range: 1 <= x <= 300
height
integer
Height specifies the output video height in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
hls_enc
boolean
HlsEnc enables encryption for HLS segments when set to true.
Examples:
false
hls_enc_iv
string
HlsEncIv specifies the initialization vector for encryption. Maximum length: 64 characters.
Required when HlsEnc is true.
Examples:
0123456789abcdef
hls_enc_key
string
HlsEncKey specifies the encryption key for HLS segments. Maximum length: 64 characters.
Required when HlsEnc is true.
Examples:
0123456789abcdef
hls_enc_key_url
string
HlsEncKeyUrl specifies the URL where clients can fetch the encryption key.
Required when HlsEnc is true.
Examples:
https://example.com/key
hls_segment_type
default: "fmp4"
string
HlsSegmentType specifies the type of HLS segments. Valid values:
mpegts: Traditional MPEG-TS segments, better compatibility
fmp4: Fragmented MP4 segments, better efficiency
Available options:
mpegtsfmp4
Examples:
mpegts
hls_time
default: 4
integer
HlsTime specifies the duration of each HLS segment in seconds. Range: 1 to 10.
Shorter segments provide faster startup but more overhead, longer segments are more efficient.
Required range: 1 <= x <= 10
Examples:
6
level
integer
Level specifies the H.265 profile level. Valid values: 30-31 (main), 41 (main10).
Higher levels support higher resolutions and bitrates but require more processing power.
Available options:
303141
Examples:
41
maxrate
integer
Maxrate specifies the maximum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate specifies the minimum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
movflags
string
per_title
default: false
boolean
Enables per-title optimization. Disabled by default. Set it to true to let Chunkify select rate control automatically. When enabled, explicit rate-control fields cannot be provided. For HLS outputs, either audio_bitrate or video_bitrate is required when per-title optimization is disabled or omitted.
pixfmt
default: "yuv420p"
string
PixFmt specifies the pixel format.
Valid value: yuv420p
Preset specifies the encoding speed preset. Valid values (from fastest to slowest):
ultrafast: Fastest encoding, lowest quality
superfast: Very fast encoding, lower quality
veryfast: Fast encoding, moderate quality
faster: Faster encoding, good quality
fast: Fast encoding, better quality
medium: Balanced preset, best quality
Available options:
ultrafastsuperfastveryfastfasterfastmedium
Examples:
medium
profilev
string
Profilev specifies the H.265 profile. Valid values:
main: Main profile, good for most applications
main10: Main 10-bit profile, supports 10-bit color
mainstillpicture: Still picture profile, optimized for single images
Available options:
mainmain10mainstillpicture
Examples:
main10
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
video_bitrate
integer
VideoBitrate specifies the video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
width
integer
Width specifies the output video width in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
x265_keyint
integer
X265KeyInt specifies the maximum number of frames between keyframes for H.265 encoding.
Range: 1 to 300. Higher values can improve compression but may affect seeking.
Required range: 1 <= x <= 300
Examples:
60
FFmpeg encoding parameters specific to JPEG image extraction.
id
"jpg"
string
required
interval
integer
required
Time interval in seconds at which frames are extracted from the video (e.g., interval=10 extracts frames at 0s, 10s, 20s, etc.).
Must be between 1 and 60 seconds.
Required range: 1 <= x <= 60
chunk_duration
integer
Required range: x >= 1
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
frames
integer
Required range: x >= 1
height
integer
Required range: -2 <= x <= 3840
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
sprite
boolean
width
integer
Required range: -2 <= x <= 3840
source_id
string
required
The ID of the source file to transcode
Examples:
src_UioP9I876hjKlNBH78ILp0mo56t
hls_manifest_id
string
Optional HLS manifest configuration
Use the same hls manifest ID to group multiple jobs into a single HLS manifest
By default, it's automatically generated if no set for HLS jobs
Examples:
hls_2v6EIgcNAycdS5g0IUm0TXBjvHV
metadata
object
Optional metadata to attach to the job, the maximum size allowed is 2048 bytes
Examples:
map[key:value key2:value2]
storage
object
Optional storage configuration
id
string
Storage Id specifies the storage configuration to use from pre-configured storage options.
Must be 4-64 characters long and contain only alphanumeric characters, underscores and hyphens.
Optional if Storage Path is provided.
Examples:
aws-my-storage
path
string
Storage Path specifies an object path relative to the selected storage connection's base_prefix. Do not include the base_prefix. Leading slashes are accepted for compatibility and removed before the path is stored. The base_prefix and normalized path may contain at most 1024 bytes combined. Optional if Storage Id is provided.
Examples:
exports/video.mp4
transcoder
object
Optional transcoder configuration. If not provided, the system will automatically
calculate the optimal quantity and CPU type based on the source file specifications
and output requirements. This auto-scaling ensures efficient resource utilization.
quantity
integer
Quantity specifies the number of transcoder instances.
Required if Type is set.
Required range: 1 <= x <= 128
Examples:
2
type
string
Type specifies the CPU configuration for each transcoder instance.
Required if Quantity is set.
Available options:
4vCPU8vCPU16vCPU
Responses
application/json
data
object
required
Data contains the response object
billable_time
integer
required
Billable time in seconds
Examples:
120
created_at
string
date-time
required
Creation timestamp
Examples:
2025-01-01T12:00:00Z
format
object
required
Format configuration used for transcoding
FFmpeg encoding parameters specific to MP4 with AV1 encoding.
id
"mp4_av1"
string
required
per_title
default: false
boolean
required
Enables per-title optimization. Disabled by default. Set it to true to let Chunkify select rate control automatically. When enabled, explicit rate-control fields cannot be provided. For HLS outputs, either audio_bitrate or video_bitrate is required when per-title optimization is disabled or omitted.
audio_bitrate
integer
AudioBitrate specifies the audio bitrate in bits per second.
Must be between 32Kbps and 512Kbps.
Required range: 32000 <= x <= 512000
bufsize
integer
Bufsize specifies the video buffer size in bits.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
channels
integer
Channels specifies the number of audio channels.
Valid values: 1 (mono), 2 (stereo), 5 (5.1), 7 (7.1)
Available options:
1257
crf
default: 35
integer
Crf (Constant Rate Factor) controls the quality of the output video.
Lower values mean better quality but larger file size. Range: 16 to 63.
Recommended values: 16-35 for high quality, 35-45 for good quality, 45-63 for acceptable quality.
Required range: 16 <= x <= 63
Examples:
35
disable_audio
boolean
DisableAudio indicates whether to disable audio processing.
disable_video
boolean
DisableVideo indicates whether to disable video processing.
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
framerate
number
Framerate specifies the output video frame rate.
Must be between 15 and 120 fps.
Required range: 15 <= x <= 120
gop
integer
Gop specifies the Group of Pictures (GOP) size.
Must be between 1 and 300.
Required range: 1 <= x <= 300
height
integer
Height specifies the output video height in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
level
integer
Level specifies the AV1 profile level. Valid values: 30-31 (main), 41 (main10).
Higher levels support higher resolutions and bitrates but require more processing power.
Available options:
303141
Examples:
41
maxrate
integer
Maxrate specifies the maximum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate specifies the minimum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
movflags
string
pixfmt
default: "yuv420p"
string
PixFmt specifies the pixel format.
Valid value: yuv420p
Preset controls the encoding efficiency and processing intensity. Lower presets use more
optimization features, creating smaller files with better quality but requiring more compute time.
Higher presets encode faster but produce larger files.
Preset ranges:
6-7: Fast encoding for real-time applications (smaller files)
8-10: Balanced efficiency and speed for general use
11-13: Fastest encoding for real-time applications (larger files)
Available options:
678910111213
Examples:
10
profilev
string
Profilev specifies the AV1 profile. Valid values:
main: Main profile, good for most applications
main10: Main 10-bit profile, supports 10-bit color
mainstillpicture: Still picture profile, optimized for single images
Available options:
mainmain10mainstillpicture
Examples:
main10
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
video_bitrate
integer
VideoBitrate specifies the video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
width
integer
Width specifies the output video width in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
FFmpeg encoding parameters specific to MP4 with H.264 encoding.
id
"mp4_h264"
string
required
per_title
default: false
boolean
required
Enables per-title optimization. Disabled by default. Set it to true to let Chunkify select rate control automatically. When enabled, explicit rate-control fields cannot be provided. For HLS outputs, either audio_bitrate or video_bitrate is required when per-title optimization is disabled or omitted.
audio_bitrate
integer
AudioBitrate specifies the audio bitrate in bits per second.
Must be between 32Kbps and 512Kbps.
Required range: 32000 <= x <= 512000
bufsize
integer
Bufsize specifies the video buffer size in bits.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
channels
integer
Channels specifies the number of audio channels.
Valid values: 1 (mono), 2 (stereo), 5 (5.1), 7 (7.1)
Available options:
1257
crf
default: 21
integer
Crf (Constant Rate Factor) controls the quality of the output video.
Lower values mean better quality but larger file size. Range: 16 to 35.
Recommended values: 18-28 for high quality, 23-28 for good quality, 28-35 for acceptable quality.
Required range: 16 <= x <= 35
Examples:
23
disable_audio
boolean
DisableAudio indicates whether to disable audio processing.
disable_video
boolean
DisableVideo indicates whether to disable video processing.
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
framerate
number
Framerate specifies the output video frame rate.
Must be between 15 and 120 fps.
Required range: 15 <= x <= 120
gop
integer
Gop specifies the Group of Pictures (GOP) size.
Must be between 1 and 300.
Required range: 1 <= x <= 300
height
integer
Height specifies the output video height in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
level
integer
Level specifies the H.264 profile level. Valid values: 10-13 (baseline), 20-22 (main), 30-32 (high), 40-42 (high), 50-51 (high).
Higher levels support higher resolutions and bitrates but require more processing power.
Available options:
101112132021223031324041425051
Examples:
41
maxrate
integer
Maxrate specifies the maximum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate specifies the minimum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
movflags
string
pixfmt
default: "yuv420p"
string
PixFmt specifies the pixel format.
Valid value: yuv420p
Preset specifies the encoding speed preset. Valid values (from fastest to slowest):
ultrafast: Fastest encoding, lowest quality
superfast: Very fast encoding, lower quality
veryfast: Fast encoding, moderate quality
faster: Faster encoding, good quality
fast: Fast encoding, better quality
medium: Balanced preset, best quality
Available options:
ultrafastsuperfastveryfastfasterfastmedium
Examples:
medium
profilev
string
Profilev specifies the H.264 profile. Valid values:
baseline: Basic profile, good for mobile devices
main: Main profile, good for most applications
high: High profile, best quality but requires more processing
high10: High 10-bit profile, supports 10-bit color
high422: High 4:2:2 profile, supports 4:2:2 color sampling
high444: High 4:4:4 profile, supports 4:4:4 color sampling
Available options:
baselinemainhighhigh10high422high444
Examples:
high
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
video_bitrate
integer
VideoBitrate specifies the video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
width
integer
Width specifies the output video width in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
x264_keyint
integer
X264KeyInt specifies the maximum number of frames between keyframes for H.264 encoding.
Range: 1 to 300. Higher values can improve compression but may affect seeking.
Required range: 1 <= x <= 300
Examples:
60
FFmpeg encoding parameters specific to MP4 with H.265 encoding.
id
"mp4_h265"
string
required
per_title
default: false
boolean
required
Enables per-title optimization. Disabled by default. Set it to true to let Chunkify select rate control automatically. When enabled, explicit rate-control fields cannot be provided. For HLS outputs, either audio_bitrate or video_bitrate is required when per-title optimization is disabled or omitted.
audio_bitrate
integer
AudioBitrate specifies the audio bitrate in bits per second.
Must be between 32Kbps and 512Kbps.
Required range: 32000 <= x <= 512000
bufsize
integer
Bufsize specifies the video buffer size in bits.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
channels
integer
Channels specifies the number of audio channels.
Valid values: 1 (mono), 2 (stereo), 5 (5.1), 7 (7.1)
Available options:
1257
crf
default: 24
integer
Crf (Constant Rate Factor) controls the quality of the output video.
Lower values mean better quality but larger file size. Range: 16 to 35.
Recommended values: 18-28 for high quality, 23-28 for good quality, 28-35 for acceptable quality.
Required range: 16 <= x <= 35
Examples:
23
disable_audio
boolean
DisableAudio indicates whether to disable audio processing.
disable_video
boolean
DisableVideo indicates whether to disable video processing.
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
framerate
number
Framerate specifies the output video frame rate.
Must be between 15 and 120 fps.
Required range: 15 <= x <= 120
gop
integer
Gop specifies the Group of Pictures (GOP) size.
Must be between 1 and 300.
Required range: 1 <= x <= 300
height
integer
Height specifies the output video height in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
level
integer
Level specifies the H.265 profile level. Valid values: 30-31 (main), 41 (main10).
Higher levels support higher resolutions and bitrates but require more processing power.
Available options:
303141
Examples:
41
maxrate
integer
Maxrate specifies the maximum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate specifies the minimum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
movflags
string
pixfmt
default: "yuv420p"
string
PixFmt specifies the pixel format.
Valid value: yuv420p
Preset specifies the encoding speed preset. Valid values (from fastest to slowest):
ultrafast: Fastest encoding, lowest quality
superfast: Very fast encoding, lower quality
veryfast: Fast encoding, moderate quality
faster: Faster encoding, good quality
fast: Fast encoding, better quality
medium: Balanced preset, best quality
Available options:
ultrafastsuperfastveryfastfasterfastmedium
Examples:
medium
profilev
string
Profilev specifies the H.265 profile. Valid values:
main: Main profile, good for most applications
main10: Main 10-bit profile, supports 10-bit color
mainstillpicture: Still picture profile, optimized for single images
Available options:
mainmain10mainstillpicture
Examples:
main10
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
video_bitrate
integer
VideoBitrate specifies the video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
width
integer
Width specifies the output video width in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
x265_keyint
integer
X265KeyInt specifies the maximum number of frames between keyframes for H.265 encoding.
Range: 1 to 300. Higher values can improve compression but may affect seeking.
Required range: 1 <= x <= 300
Examples:
60
FFmpeg encoding parameters specific to WebM with VP9 encoding.
id
"webm_vp9"
string
required
per_title
default: false
boolean
required
Enables per-title optimization. Disabled by default. Set it to true to let Chunkify select rate control automatically. When enabled, explicit rate-control fields cannot be provided. For HLS outputs, either audio_bitrate or video_bitrate is required when per-title optimization is disabled or omitted.
audio_bitrate
integer
AudioBitrate specifies the audio bitrate in bits per second.
Must be between 32Kbps and 512Kbps.
Required range: 32000 <= x <= 512000
bufsize
integer
Bufsize specifies the video buffer size in bits.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
channels
integer
Channels specifies the number of audio channels.
Valid values: 1 (mono), 2 (stereo), 5 (5.1), 7 (7.1)
Available options:
1257
cpu_used
default: "5"
string
CpuUsed specifies the CPU usage level for VP9 encoding. Range: 0 to 8.
Lower values mean better quality but slower encoding, higher values mean faster encoding but lower quality.
Recommended values: 0-2 for high quality, 2-4 for good quality, 4-6 for balanced, 6-8 for speed
Available options:
012345678
Examples:
4
crf
default: 24
integer
Crf (Constant Rate Factor) controls the quality of the output video.
Lower values mean better quality but larger file size. Range: 15 to 35.
Recommended values: 18-28 for high quality, 23-28 for good quality, 28-35 for acceptable quality.
Required range: 15 <= x <= 35
Examples:
23
disable_audio
boolean
DisableAudio indicates whether to disable audio processing.
disable_video
boolean
DisableVideo indicates whether to disable video processing.
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
framerate
number
Framerate specifies the output video frame rate.
Must be between 15 and 120 fps.
Required range: 15 <= x <= 120
gop
integer
Gop specifies the Group of Pictures (GOP) size.
Must be between 1 and 300.
Required range: 1 <= x <= 300
height
integer
Height specifies the output video height in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
maxrate
integer
Maxrate specifies the maximum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate specifies the minimum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
pixfmt
default: "yuv420p"
string
PixFmt specifies the pixel format.
Valid value: yuv420p
Quality specifies the VP9 encoding quality preset. Valid values:
good: Balanced quality preset, good for most applications
best: Best quality preset, slower encoding
realtime: Fast encoding preset, suitable for live streaming
Available options:
goodbestrealtime
Examples:
good
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
video_bitrate
integer
VideoBitrate specifies the video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
width
integer
Width specifies the output video width in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
FFmpeg encoding parameters specific to HLS with AV1 encoding. When per-title optimization is disabled, either audio_bitrate or video_bitrate is required.
id
"hls_av1"
string
required
per_title
default: false
boolean
required
Enables per-title optimization. Disabled by default. Set it to true to let Chunkify select rate control automatically. When enabled, explicit rate-control fields cannot be provided. For HLS outputs, either audio_bitrate or video_bitrate is required when per-title optimization is disabled or omitted.
audio_bitrate
integer
AudioBitrate specifies the audio bitrate in bits per second.
Must be between 32Kbps and 512Kbps.
Required range: 32000 <= x <= 512000
bufsize
integer
Bufsize specifies the video buffer size in bits.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
channels
integer
Channels specifies the number of audio channels.
Valid values: 1 (mono), 2 (stereo), 5 (5.1), 7 (7.1)
Available options:
1257
crf
default: 35
integer
Crf (Constant Rate Factor) controls the quality of the output video.
Lower values mean better quality but larger file size. Range: 16 to 63.
Recommended values: 16-35 for high quality, 35-45 for good quality, 45-63 for acceptable quality.
Required range: 16 <= x <= 63
Examples:
35
disable_audio
boolean
DisableAudio indicates whether to disable audio processing.
disable_video
boolean
DisableVideo indicates whether to disable video processing.
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
framerate
number
Framerate specifies the output video frame rate.
Must be between 15 and 120 fps.
Required range: 15 <= x <= 120
gop
integer
Gop specifies the Group of Pictures (GOP) size.
Must be between 1 and 300.
Required range: 1 <= x <= 300
height
integer
Height specifies the output video height in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
hls_enc
boolean
HlsEnc enables encryption for HLS segments when set to true.
Examples:
false
hls_enc_iv
string
HlsEncIv specifies the initialization vector for encryption. Maximum length: 64 characters.
Required when HlsEnc is true.
Examples:
0123456789abcdef
hls_enc_key
string
HlsEncKey specifies the encryption key for HLS segments. Maximum length: 64 characters.
Required when HlsEnc is true.
Examples:
0123456789abcdef
hls_enc_key_url
string
HlsEncKeyUrl specifies the URL where clients can fetch the encryption key.
Required when HlsEnc is true.
Examples:
https://example.com/key
hls_segment_type
default: "fmp4"
string
HlsSegmentType specifies the type of HLS segments. Valid values:
mpegts: Traditional MPEG-TS segments, better compatibility
fmp4: Fragmented MP4 segments, better efficiency
Available options:
mpegtsfmp4
Examples:
mpegts
hls_time
default: 4
integer
HlsTime specifies the duration of each HLS segment in seconds. Range: 1 to 10.
Shorter segments provide faster startup but more overhead, longer segments are more efficient.
Required range: 1 <= x <= 10
Examples:
6
level
integer
Level specifies the AV1 profile level. Valid values: 30-31 (main), 41 (main10).
Higher levels support higher resolutions and bitrates but require more processing power.
Available options:
303141
Examples:
41
maxrate
integer
Maxrate specifies the maximum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate specifies the minimum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
movflags
string
pixfmt
default: "yuv420p"
string
PixFmt specifies the pixel format.
Valid value: yuv420p
Preset controls the encoding efficiency and processing intensity. Lower presets use more
optimization features, creating smaller files with better quality but requiring more compute time.
Higher presets encode faster but produce larger files.
Preset ranges:
6-7: Fast encoding for real-time applications (smaller files)
8-10: Balanced efficiency and speed for general use
11-13: Fastest encoding for real-time applications (larger files)
Available options:
678910111213
Examples:
10
profilev
string
Profilev specifies the AV1 profile. Valid values:
main: Main profile, good for most applications
main10: Main 10-bit profile, supports 10-bit color
mainstillpicture: Still picture profile, optimized for single images
Available options:
mainmain10mainstillpicture
Examples:
main10
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
video_bitrate
integer
VideoBitrate specifies the video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
width
integer
Width specifies the output video width in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
FFmpeg encoding parameters specific to HLS with H.264 encoding. When per-title optimization is disabled, either audio_bitrate or video_bitrate is required.
id
"hls_h264"
string
required
per_title
default: false
boolean
required
Enables per-title optimization. Disabled by default. Set it to true to let Chunkify select rate control automatically. When enabled, explicit rate-control fields cannot be provided. For HLS outputs, either audio_bitrate or video_bitrate is required when per-title optimization is disabled or omitted.
audio_bitrate
integer
AudioBitrate specifies the audio bitrate in bits per second.
Must be between 32Kbps and 512Kbps.
Required range: 32000 <= x <= 512000
bufsize
integer
Bufsize specifies the video buffer size in bits.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
channels
integer
Channels specifies the number of audio channels.
Valid values: 1 (mono), 2 (stereo), 5 (5.1), 7 (7.1)
Available options:
1257
crf
default: 21
integer
Crf (Constant Rate Factor) controls the quality of the output video.
Lower values mean better quality but larger file size. Range: 16 to 35.
Recommended values: 18-28 for high quality, 23-28 for good quality, 28-35 for acceptable quality.
Required range: 16 <= x <= 35
Examples:
23
disable_audio
boolean
DisableAudio indicates whether to disable audio processing.
disable_video
boolean
DisableVideo indicates whether to disable video processing.
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
framerate
number
Framerate specifies the output video frame rate.
Must be between 15 and 120 fps.
Required range: 15 <= x <= 120
gop
integer
Gop specifies the Group of Pictures (GOP) size.
Must be between 1 and 300.
Required range: 1 <= x <= 300
height
integer
Height specifies the output video height in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
hls_enc
boolean
HlsEnc enables encryption for HLS segments when set to true.
Examples:
false
hls_enc_iv
string
HlsEncIv specifies the initialization vector for encryption. Maximum length: 64 characters.
Required when HlsEnc is true.
Examples:
0123456789abcdef
hls_enc_key
string
HlsEncKey specifies the encryption key for HLS segments. Maximum length: 64 characters.
Required when HlsEnc is true.
Examples:
0123456789abcdef
hls_enc_key_url
string
HlsEncKeyUrl specifies the URL where clients can fetch the encryption key.
Required when HlsEnc is true.
Examples:
https://example.com/key
hls_segment_type
default: "fmp4"
string
HlsSegmentType specifies the type of HLS segments. Valid values:
mpegts: Traditional MPEG-TS segments, better compatibility
fmp4: Fragmented MP4 segments, better efficiency
Available options:
mpegtsfmp4
Examples:
mpegts
hls_time
default: 4
integer
HlsTime specifies the duration of each HLS segment in seconds. Range: 1 to 10.
Shorter segments provide faster startup but more overhead, longer segments are more efficient.
Required range: 1 <= x <= 10
Examples:
6
level
integer
Level specifies the H.264 profile level. Valid values: 10-13 (baseline), 20-22 (main), 30-32 (high), 40-42 (high), 50-51 (high).
Higher levels support higher resolutions and bitrates but require more processing power.
Available options:
101112132021223031324041425051
Examples:
41
maxrate
integer
Maxrate specifies the maximum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate specifies the minimum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
movflags
string
pixfmt
default: "yuv420p"
string
PixFmt specifies the pixel format.
Valid value: yuv420p
Preset specifies the encoding speed preset. Valid values (from fastest to slowest):
ultrafast: Fastest encoding, lowest quality
superfast: Very fast encoding, lower quality
veryfast: Fast encoding, moderate quality
faster: Faster encoding, good quality
fast: Fast encoding, better quality
medium: Balanced preset, best quality
Available options:
ultrafastsuperfastveryfastfasterfastmedium
Examples:
medium
profilev
string
Profilev specifies the H.264 profile. Valid values:
baseline: Basic profile, good for mobile devices
main: Main profile, good for most applications
high: High profile, best quality but requires more processing
high10: High 10-bit profile, supports 10-bit color
high422: High 4:2:2 profile, supports 4:2:2 color sampling
high444: High 4:4:4 profile, supports 4:4:4 color sampling
Available options:
baselinemainhighhigh10high422high444
Examples:
high
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
video_bitrate
integer
VideoBitrate specifies the video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
width
integer
Width specifies the output video width in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
x264_keyint
integer
X264KeyInt specifies the maximum number of frames between keyframes for H.264 encoding.
Range: 1 to 300. Higher values can improve compression but may affect seeking.
Required range: 1 <= x <= 300
Examples:
60
FFmpeg encoding parameters specific to HLS with H.265 encoding. When per-title optimization is disabled, either audio_bitrate or video_bitrate is required.
id
"hls_h265"
string
required
per_title
default: false
boolean
required
Enables per-title optimization. Disabled by default. Set it to true to let Chunkify select rate control automatically. When enabled, explicit rate-control fields cannot be provided. For HLS outputs, either audio_bitrate or video_bitrate is required when per-title optimization is disabled or omitted.
audio_bitrate
integer
AudioBitrate specifies the audio bitrate in bits per second.
Must be between 32Kbps and 512Kbps.
Required range: 32000 <= x <= 512000
bufsize
integer
Bufsize specifies the video buffer size in bits.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
channels
integer
Channels specifies the number of audio channels.
Valid values: 1 (mono), 2 (stereo), 5 (5.1), 7 (7.1)
Available options:
1257
crf
default: 24
integer
Crf (Constant Rate Factor) controls the quality of the output video.
Lower values mean better quality but larger file size. Range: 16 to 35.
Recommended values: 18-28 for high quality, 23-28 for good quality, 28-35 for acceptable quality.
Required range: 16 <= x <= 35
Examples:
23
disable_audio
boolean
DisableAudio indicates whether to disable audio processing.
disable_video
boolean
DisableVideo indicates whether to disable video processing.
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
framerate
number
Framerate specifies the output video frame rate.
Must be between 15 and 120 fps.
Required range: 15 <= x <= 120
gop
integer
Gop specifies the Group of Pictures (GOP) size.
Must be between 1 and 300.
Required range: 1 <= x <= 300
height
integer
Height specifies the output video height in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
hls_enc
boolean
HlsEnc enables encryption for HLS segments when set to true.
Examples:
false
hls_enc_iv
string
HlsEncIv specifies the initialization vector for encryption. Maximum length: 64 characters.
Required when HlsEnc is true.
Examples:
0123456789abcdef
hls_enc_key
string
HlsEncKey specifies the encryption key for HLS segments. Maximum length: 64 characters.
Required when HlsEnc is true.
Examples:
0123456789abcdef
hls_enc_key_url
string
HlsEncKeyUrl specifies the URL where clients can fetch the encryption key.
Required when HlsEnc is true.
Examples:
https://example.com/key
hls_segment_type
default: "fmp4"
string
HlsSegmentType specifies the type of HLS segments. Valid values:
mpegts: Traditional MPEG-TS segments, better compatibility
fmp4: Fragmented MP4 segments, better efficiency
Available options:
mpegtsfmp4
Examples:
mpegts
hls_time
default: 4
integer
HlsTime specifies the duration of each HLS segment in seconds. Range: 1 to 10.
Shorter segments provide faster startup but more overhead, longer segments are more efficient.
Required range: 1 <= x <= 10
Examples:
6
level
integer
Level specifies the H.265 profile level. Valid values: 30-31 (main), 41 (main10).
Higher levels support higher resolutions and bitrates but require more processing power.
Available options:
303141
Examples:
41
maxrate
integer
Maxrate specifies the maximum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate specifies the minimum video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
movflags
string
pixfmt
default: "yuv420p"
string
PixFmt specifies the pixel format.
Valid value: yuv420p
Preset specifies the encoding speed preset. Valid values (from fastest to slowest):
ultrafast: Fastest encoding, lowest quality
superfast: Very fast encoding, lower quality
veryfast: Fast encoding, moderate quality
faster: Faster encoding, good quality
fast: Fast encoding, better quality
medium: Balanced preset, best quality
Available options:
ultrafastsuperfastveryfastfasterfastmedium
Examples:
medium
profilev
string
Profilev specifies the H.265 profile. Valid values:
main: Main profile, good for most applications
main10: Main 10-bit profile, supports 10-bit color
mainstillpicture: Still picture profile, optimized for single images
Available options:
mainmain10mainstillpicture
Examples:
main10
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
video_bitrate
integer
VideoBitrate specifies the video bitrate in bits per second.
Must be between 100Kbps and 50Mbps.
Required range: 100000 <= x <= 5e+07
width
integer
Width specifies the output video width in pixels.
Must be between -2 and 7680. Use -2 for automatic calculation while maintaining aspect ratio.
Required range: -2 <= x <= 7680
x265_keyint
integer
X265KeyInt specifies the maximum number of frames between keyframes for H.265 encoding.
Range: 1 to 300. Higher values can improve compression but may affect seeking.
Required range: 1 <= x <= 300
Examples:
60
FFmpeg encoding parameters specific to JPEG image extraction.
id
"jpg"
string
required
interval
integer
required
Time interval in seconds at which frames are extracted from the video (e.g., interval=10 extracts frames at 0s, 10s, 20s, etc.).
Must be between 1 and 60 seconds.
Required range: 1 <= x <= 60
per_title
boolean
required
Whether per-title optimization was enabled for this job.
chunk_duration
integer
Required range: x >= 1
duration
integer
Duration specifies the duration to process in seconds.
Must be a positive value.
Required range: x >= 1
frames
integer
Required range: x >= 1
height
integer
Required range: -2 <= x <= 3840
seek
integer
Seek specifies the timestamp to start processing from (in seconds).
Must be a positive value.
Required range: x >= 1
sprite
boolean
width
integer
Required range: -2 <= x <= 3840
id
string
required
Unique identifier for the job
Examples:
job_2G6MJiNz71bHQGNzGwKx5cJwPFS
progress
number
required
Progress percentage of the job (0-100)
Examples:
45.5
source_id
string
required
ID of the source video being transcoded
Examples:
src_2G6MJiNz71bHQGNzGwKx5cJwPFS
status
default: "pending"
string
required
Current status of the job. New jobs start as pending while waiting for scheduler admission, then become queued when admitted for processing.