Jobs

Get all jobs

Retrieve a list of jobs with optional filtering and pagination

GET

/api/jobs

Authorization

header

string

required

Enter the project access token with the Bearer prefix, e.g. "Bearer project_access_token"

Query Parameters

string

Filter by job ID

offset

default: 0

integer

Pagination offset

Required range: x >= 0

limit

default: 100

integer

Pagination limit

Required range: 1 <= x <= 100

created.gte

integer

epoch

Filter by creation date greater than or equal

Required range: x >= 0

Examples:

1764238404

created.lte

integer

epoch

Filter by creation date less than or equal

Required range: x >= 0

Examples:

1764238404

source_id

string

Filter by source ID

hls_manifest_id

string

Filter by hls manifest ID

status

string

Filter by job status

Available options:

completedprocessingfailedcancelledqueuedpending

format_id

string

Filter by format id

Available options:

mp4_h264mp4_h265mp4_av1webm_vp9hls_h264hls_h265hls_av1jpg

metadata

array[]

Filter by metadata

created.sort

default: "asc"

string

Sort by creation date (asc/desc)

Available options:

ascdesc

Responses

application/json

data

object[]

required

Data contains the paginated job items

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.

"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

Available options:

yuv410pyuv411pyuv420pyuv422pyuv440pyuv444pyuvJ411pyuvJ420pyuvJ422pyuvJ440pyuvJ444pyuv420p10leyuv422p10leyuv440p10leyuv444p10leyuv420p12leyuv422p12leyuv440p12leyuv444p12leyuv420p10beyuv422p10beyuv440p10beyuv444p10beyuv420p12beyuv422p12beyuv440p12beyuv444p12be

preset

default: "10"

string

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.

"mp4_h264"

string

required

per_title

default: false

boolean

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

pixfmt

default: "yuv420p"

string

PixFmt specifies the pixel format. Valid value: yuv420p

Available options:

preset

default: "veryfast"

string

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.

"mp4_h265"

string

required

per_title

default: false

boolean

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

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

Available options:

preset

default: "veryfast"

string

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.

"webm_vp9"

string

required

per_title

default: false

boolean

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

pixfmt

default: "yuv420p"

string

PixFmt specifies the pixel format. Valid value: yuv420p

Available options:

quality

default: "realtime"

string

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.

"hls_av1"

string

required

per_title

default: false

boolean

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

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

Available options:

preset

default: "10"

string

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.

"hls_h264"

string

required

per_title

default: false

boolean

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

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

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

Available options:

preset

default: "veryfast"

string

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.

"hls_h265"

string

required

per_title

default: false

boolean

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

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

Available options:

preset

default: "veryfast"

string

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.

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.

Available options:

pendingqueuedingestingtranscodingdownloadingmerginguploadingfailedcompletedcancelledmergeddownloadedtranscodedwaiting

Examples:

pending

storage

object

required

Storage configuration for the job output

transcoder

object

required

Transcoder configuration and status

updated_at

string

date-time

required

Last update timestamp

Examples:

2025-01-01T12:05:00Z

error

object

Error message for the job

hls_manifest_id

string

HLS manifest ID

Examples:

hls_2v6EIgcNAycdS5g0IUm0TXBjvHV

metadata

object

Additional metadata for the job

Examples:

map[key1:value1 key2:value2]

started_at

string

date-time

When the job started processing

Examples:

2025-01-01T12:01:00Z

limit

integer

required

Limit indicates the maximum number of items in the current response

offset

integer

required

Offset indicates the offset of the first item in the current response

status

"success"

string

required

Status indicates the response status "success"

total

integer

required

Total indicates the total number of items

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Authentication error: invalid token or subscription inactive

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Rate limit exceeded

import Chunkify from '@chunkify/chunkify'; const client = new Chunkify({ projectAccessToken: 'My Project Access Token', }); // Automatically fetches more pages as needed. for await (const job of client.jobs.list()) { console.log(job.id); }

<?php use Chunkify\Client; $client = new Client( projectAccessToken: 'My Project Access Token', ); // Automatically fetches more pages as needed. foreach ($client->jobs->list()->pagingEachItem() as $job) { var_dump($job->id); }

package main import ( "context" "fmt" "github.com/chunkifydev/chunkify-go" "github.com/chunkifydev/chunkify-go/option" ) func main() { client := chunkify.NewClient( option.WithProjectAccessToken("My Project Access Token"), ) page, err := client.Jobs.List(context.TODO(), chunkify.JobListParams{}) if err != nil { panic(err.Error()) } // Loop through the pages and print the job IDs for page != nil { for _, job := range page.Data { fmt.Printf("%+v\n", job.ID) } page, err = page.GetNextPage() if err != nil { panic(err.Error()) } } }

{ "data": [ { "billable_time": 120, "created_at": "2025-01-01T12:00:00Z", "format": { "id": "mp4_av1", "per_title": false }, "id": "job_2G6MJiNz71bHQGNzGwKx5cJwPFS", "progress": 45.5, "source_id": "src_2G6MJiNz71bHQGNzGwKx5cJwPFS", "status": "pending", "storage": { "id": "stor_aws_S1cce6120E56e7Tu9ioP09Nhjk1", "path": "path/to/video.mp4" }, "transcoder": { "auto": true, "quantity": 10, "type": "4vCPU" }, "updated_at": "2025-01-01T12:05:00Z" } ], "limit": "<integer>", "offset": "<integer>", "status": "success", "total": "<integer>" }