Bufsize specifies the video buffer size in bits, from 100000 through 50000000. H.264 and H.265 require maxrate. AV1 and VP9 require a bitrate-controlled mode.
Required range: 100000 <= x <= 5e+07
channels
default: 2
integer
Channels specifies the output channel count. Defaults to stereo. Six channels means 5.1; eight means 7.1.
Available options:
1268
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 omits the audio stream. Defaults to false. A source without audio produces video only.
disable_video
boolean
DisableVideo selects an audio-only AAC M4A export. Defaults to false. The source must contain audio.
duration
number
Duration specifies the requested output length in seconds. Defaults to the remaining source duration and is capped at the source end. Audio-only output must resolve to at least 0.001 seconds after trimming and sample rounding. The accepted interval determines the fixed price.
framerate
number
Framerate specifies the output video frame rate. Defaults to the source rate and must be between 0.001 and 240 fps.
Required range: 0.001 <= x <= 240
gop
integer
Gop specifies the maximum keyframe interval in frames. Defaults to four seconds at the accepted frame rate, capped at 960 frames.
Required range: 1 <= x <= 960
height
integer
Height specifies the output dimension in pixels. Use -2 or omit one dimension to preserve the source aspect ratio. Explicit dimensions must be 2 to 7680 and even. Omitting both preserves the source dimensions rounded down to even pixels.
Required range: -2 <= x <= 7680
level
integer
Level specifies the H.264 decoder level using its two-digit representation, such as 41 for level 4.1. The dimensions, frame rate and rate controls must fit this level and the effective profile. Omitted rate limits resolve to level-compatible defaults.
Available options:
101112132021223031324041425051
Examples:
41
maxrate
integer
Maxrate specifies the video buffer maximum rate in bits per second, from 100000 through 50000000. H.264 and H.265 require bufsize. VP9 requires video_bitrate; AV1 requires CRF mode.
Required range: 100000 <= x <= 5e+07
movflags
default: "faststart"
string
Movflags specifies MP4 packaging. Defaults to faststart, which places playback metadata before the media.
Available options:
faststart
per_title
default: false
boolean
PerTitle enables independent content-based bitrate prediction for each part of the video. Analysis uses only the selected trim interval. Defaults to false. Explicit rate-control settings cannot be combined with it.
pixfmt
default: "yuv420p"
string
Pixfmt specifies the output pixel format. Defaults to yuv420p. The selected profile must support it.
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
number
Seek specifies the start in source seconds. Defaults to zero and must precede the source end. The accepted interval uses the output frame or sample timeline. Audio-only output must retain at least 0.001 seconds after sample rounding.
Required range: x >= 0
video_bitrate
integer
VideoBitrate specifies the target video bitrate in bits per second, from 1000 through 100000000. Omit it for CRF or per-title encoding.
Required range: 1000 <= x <= 1e+08
width
integer
Width specifies the output dimension in pixels. Use -2 or omit one dimension to preserve the source aspect ratio. Explicit dimensions must be 2 to 7680 and even. Omitting both preserves the source dimensions rounded down to even pixels.
Required range: -2 <= x <= 7680
x264_keyint
integer
X264KeyInt specifies the maximum number of frames between keyframes for H.264 encoding.
Range: 1 to 960. Higher values can improve compression but may affect seeking.
Required range: 1 <= x <= 960
Examples:
60
mp4_h265 standalone file encoding settings.
id
"mp4_h265"
string
required
Id specifies the output format.
audio_bitrate
default: 128000
integer
AudioBitrate specifies the output audio bitrate in bits per second. Defaults to 128000.
Required range: 32000 <= x <= 512000
audio_samplerate
default: 48000
integer
AudioSamplerate specifies the output sample rate in Hz. Defaults to 48000. WebM Opus audio uses 48000.
Bufsize specifies the video buffer size in bits, from 100000 through 50000000. H.264 and H.265 require maxrate. AV1 and VP9 require a bitrate-controlled mode.
Required range: 100000 <= x <= 5e+07
channels
default: 2
integer
Channels specifies the output channel count. Defaults to stereo. Six channels means 5.1; eight means 7.1.
Available options:
1268
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 omits the audio stream. Defaults to false. A source without audio produces video only.
disable_video
boolean
DisableVideo selects an audio-only AAC M4A export. Defaults to false. The source must contain audio.
duration
number
Duration specifies the requested output length in seconds. Defaults to the remaining source duration and is capped at the source end. Audio-only output must resolve to at least 0.001 seconds after trimming and sample rounding. The accepted interval determines the fixed price.
framerate
number
Framerate specifies the output video frame rate. Defaults to the source rate and must be between 0.001 and 240 fps.
Required range: 0.001 <= x <= 240
gop
integer
Gop specifies the maximum keyframe interval in frames. Defaults to four seconds at the accepted frame rate, capped at 960 frames.
Required range: 1 <= x <= 960
height
integer
Height specifies the output dimension in pixels. Use -2 or omit one dimension to preserve the source aspect ratio. Explicit dimensions must be 2 to 7680 and even. Omitting both preserves the source dimensions rounded down to even pixels.
Required range: -2 <= x <= 7680
level
integer
Level specifies the HEVC level using its two-digit representation, such as 31 for level 3.1. The dimensions, frame rate and rate controls must fit this level. Omitted rate limits resolve to level-compatible defaults.
Available options:
303141
Examples:
41
maxrate
integer
Maxrate specifies the video buffer maximum rate in bits per second, from 100000 through 50000000. H.264 and H.265 require bufsize. VP9 requires video_bitrate; AV1 requires CRF mode.
Required range: 100000 <= x <= 5e+07
movflags
default: "faststart"
string
Movflags specifies MP4 packaging. Defaults to faststart, which places playback metadata before the media.
Available options:
faststart
per_title
default: false
boolean
PerTitle enables independent content-based bitrate prediction for each part of the video. Analysis uses only the selected trim interval. Defaults to false. Explicit rate-control settings cannot be combined with it.
pixfmt
default: "yuv420p"
string
Pixfmt specifies the output pixel format. Defaults to yuv420p. The selected profile must support it.
Seek specifies the start in source seconds. Defaults to zero and must precede the source end. The accepted interval uses the output frame or sample timeline. Audio-only output must retain at least 0.001 seconds after sample rounding.
Required range: x >= 0
video_bitrate
integer
VideoBitrate specifies the target video bitrate in bits per second, from 1000 through 100000000. Omit it for CRF or per-title encoding.
Required range: 1000 <= x <= 1e+08
width
integer
Width specifies the output dimension in pixels. Use -2 or omit one dimension to preserve the source aspect ratio. Explicit dimensions must be 2 to 7680 and even. Omitting both preserves the source dimensions rounded down to even pixels.
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
mp4_av1 standalone file encoding settings.
id
"mp4_av1"
string
required
Id specifies the output format.
audio_bitrate
default: 128000
integer
AudioBitrate specifies the output audio bitrate in bits per second. Defaults to 128000.
Required range: 32000 <= x <= 512000
audio_samplerate
default: 48000
integer
AudioSamplerate specifies the output sample rate in Hz. Defaults to 48000. WebM Opus audio uses 48000.
Bufsize specifies the video buffer size in bits, from 100000 through 50000000. H.264 and H.265 require maxrate. AV1 and VP9 require a bitrate-controlled mode.
Required range: 100000 <= x <= 5e+07
channels
default: 2
integer
Channels specifies the output channel count. Defaults to stereo. Six channels means 5.1; eight means 7.1.
Available options:
1268
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 omits the audio stream. Defaults to false. A source without audio produces video only.
disable_video
boolean
DisableVideo selects an audio-only AAC M4A export. Defaults to false. The source must contain audio.
duration
number
Duration specifies the requested output length in seconds. Defaults to the remaining source duration and is capped at the source end. Audio-only output must resolve to at least 0.001 seconds after trimming and sample rounding. The accepted interval determines the fixed price.
framerate
number
Framerate specifies the output video frame rate. Defaults to the source rate and must be between 0.001 and 240 fps.
Required range: 0.001 <= x <= 240
gop
integer
Gop specifies the maximum keyframe interval in frames. Defaults to four seconds at the accepted frame rate, capped at 960 frames.
Required range: 1 <= x <= 960
height
integer
Height specifies the output dimension in pixels. Use -2 or omit one dimension to preserve the source aspect ratio. Explicit dimensions must be 2 to 7680 and even. Omitting both preserves the source dimensions rounded down to even pixels.
Required range: -2 <= x <= 7680
level
integer
Level specifies the AV1 level using its two-digit representation, such as 31 for level 3.1. The dimensions, frame rate and rate controls must fit this level. Omitted rate limits resolve to level-compatible defaults.
Available options:
303141
Examples:
41
maxrate
integer
Maxrate specifies the video buffer maximum rate in bits per second, from 100000 through 50000000. H.264 and H.265 require bufsize. VP9 requires video_bitrate; AV1 requires CRF mode.
Required range: 100000 <= x <= 5e+07
movflags
default: "faststart"
string
Movflags specifies MP4 packaging. Defaults to faststart, which places playback metadata before the media.
Available options:
faststart
per_title
default: false
boolean
PerTitle enables independent content-based bitrate prediction for each part of the video. Analysis uses only the selected trim interval. Defaults to false. Explicit rate-control settings cannot be combined with it.
pixfmt
default: "yuv420p"
string
Pixfmt specifies the output pixel format. Defaults to yuv420p. The selected profile must support it.
Available options:
yuv420pyuv420p10le
preset
default: "8"
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 selects the AV1 Main profile. Use pixfmt to select 8-bit or 10-bit output.
Available options:
main
seek
number
Seek specifies the start in source seconds. Defaults to zero and must precede the source end. The accepted interval uses the output frame or sample timeline. Audio-only output must retain at least 0.001 seconds after sample rounding.
Required range: x >= 0
video_bitrate
integer
VideoBitrate specifies the target video bitrate in bits per second, from 1000 through 100000000. Omit it for CRF or per-title encoding.
Required range: 1000 <= x <= 1e+08
width
integer
Width specifies the output dimension in pixels. Use -2 or omit one dimension to preserve the source aspect ratio. Explicit dimensions must be 2 to 7680 and even. Omitting both preserves the source dimensions rounded down to even pixels.
Required range: -2 <= x <= 7680
webm_vp9 standalone file encoding settings.
id
"webm_vp9"
string
required
Id specifies the output format.
audio_bitrate
default: 128000
integer
AudioBitrate specifies the output audio bitrate in bits per second. Defaults to 128000.
Required range: 32000 <= x <= 512000
audio_samplerate
default: 48000
integer
AudioSamplerate specifies the output sample rate in Hz. Defaults to 48000. WebM Opus audio uses 48000.
Bufsize specifies the video buffer size in bits, from 100000 through 50000000. H.264 and H.265 require maxrate. AV1 and VP9 require a bitrate-controlled mode.
Required range: 100000 <= x <= 5e+07
channels
default: 2
integer
Channels specifies the output channel count. Defaults to stereo. Six channels means 5.1; eight means 7.1.
Available options:
1268
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 omits the audio stream. Defaults to false. A source without audio produces video only.
disable_video
boolean
DisableVideo selects an audio-only AAC M4A export. Defaults to false. The source must contain audio.
duration
number
Duration specifies the requested output length in seconds. Defaults to the remaining source duration and is capped at the source end. Audio-only output must resolve to at least 0.001 seconds after trimming and sample rounding. The accepted interval determines the fixed price.
framerate
number
Framerate specifies the output video frame rate. Defaults to the source rate and must be between 0.001 and 240 fps.
Required range: 0.001 <= x <= 240
gop
integer
Gop specifies the maximum keyframe interval in frames. Defaults to four seconds at the accepted frame rate, capped at 960 frames.
Required range: 1 <= x <= 960
height
integer
Height specifies the output dimension in pixels. Use -2 or omit one dimension to preserve the source aspect ratio. Explicit dimensions must be 2 to 7680 and even. Omitting both preserves the source dimensions rounded down to even pixels.
Required range: -2 <= x <= 7680
maxrate
integer
Maxrate specifies the video buffer maximum rate in bits per second, from 100000 through 50000000. H.264 and H.265 require bufsize. VP9 requires video_bitrate; AV1 requires CRF mode.
Required range: 100000 <= x <= 5e+07
minrate
integer
Minrate selects VP9 constant bitrate when equal to video_bitrate and maxrate. Other minimum-rate combinations are unsupported.
Required range: 100000 <= x <= 5e+07
per_title
default: false
boolean
PerTitle enables independent content-based bitrate prediction for each part of the video. Analysis uses only the selected trim interval. Defaults to false. Explicit rate-control settings cannot be combined with it.
pixfmt
default: "yuv420p"
string
Pixfmt specifies the output pixel format. Defaults to yuv420p. The selected profile must support it.
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
number
Seek specifies the start in source seconds. Defaults to zero and must precede the source end. The accepted interval uses the output frame or sample timeline. Audio-only output must retain at least 0.001 seconds after sample rounding.
Required range: x >= 0
video_bitrate
integer
VideoBitrate specifies the target video bitrate in bits per second, from 1000 through 100000000. Omit it for CRF or per-title encoding.
Required range: 1000 <= x <= 1e+08
width
integer
Width specifies the output dimension in pixels. Use -2 or omit one dimension to preserve the source aspect ratio. Explicit dimensions must be 2 to 7680 and even. Omitting both preserves the source dimensions rounded down to even pixels.
Required range: -2 <= x <= 7680
AAC audio-only export from a video or audio Source.
id
"m4a_aac"
string
required
Id specifies an AAC M4A export.
audio_bitrate
default: 128000
integer
AudioBitrate specifies the output audio bitrate in bits per second. Defaults to 128000.
Required range: 32000 <= x <= 512000
audio_samplerate
default: 48000
integer
AudioSamplerate specifies the output sample rate in Hz. Defaults to 48000. WebM Opus audio uses 48000.
Channels specifies the output channel count. Defaults to stereo. Six channels means 5.1; eight means 7.1.
Available options:
1268
duration
number
Duration specifies the requested output length in seconds. Defaults to the remaining source duration and is capped at the source end. Audio-only output must resolve to at least 0.001 seconds after trimming and sample rounding. The accepted interval determines the fixed price.
seek
number
Seek specifies the start in source seconds. Defaults to zero and must precede the source end. The accepted interval uses the output frame or sample timeline. Audio-only output must retain at least 0.001 seconds after sample rounding.
Required range: x >= 0
source_id
string
required
SourceId identifies a Source in this Project.
metadata
object
Metadata attaches string values to the Transcoding. The serialized object may contain at most 2048 bytes.
storage
object
Storage overrides the Project output destination. Source storage remains independent.
id
string
Id specifies a Storage in this Project. Defaults to the Project output storage.
Examples:
stor_example
path
string
Path specifies the output object path relative to the selected Storage base_prefix. Required for customer storage; generated for Chunkify temporary storage. The extension must match the resolved output format. The combined path may contain at most 1024 bytes.
Examples:
exports/video.mp4
Responses
application/json
data
object
required
Data contains the Transcoding.
created_at
string
date-time
required
CreatedAt specifies when the request was accepted.
files
object[]
required
Files contains the published output files and their measured properties, ordered by creation time. Empty until publication. Presigned URLs are refreshed on each read and included in lifecycle webhooks when available.
created_at
string
date-time
required
CreatedAt records when the validated file was published.
duration
number
required
Duration specifies the measured output duration in seconds.
id
string
required
Id identifies this published Transcoding file.
mime_type
string
required
MimeType specifies the media content type.
path
string
required
Path specifies the output path relative to the Storage base_prefix saved when the Transcoding was created. Later Storage prefix changes do not move this file.
size
integer
required
Size specifies the measured file size in bytes.
Required range: x >= 1
storage_id
string
required
StorageId identifies the output Storage.
thumbnails
object[]
required
Thumbnails contains available dashboard preview images. Empty for audio-only files, failed previews or expired files.
format
string
required
Format specifies the image encoding.
Available options:
jpegwebp
height
integer
required
Height specifies the measured image height in pixels.
size
integer
required
Size specifies the measured image size in bytes.
url
string
required
Url provides a signed image URL valid for at most ten minutes.
width
integer
required
Width specifies the measured image width in pixels.
transcoding_id
string
required
TranscodingId identifies the Transcoding that produced this file.
audio_bitrate
integer
AudioBitrate specifies measured audio bits per second, or zero when unavailable. Omitted without audio.
audio_codec
string
AudioCodec specifies the measured audio codec. Omitted without audio.
audio_samplerate
integer
AudioSamplerate specifies measured audio samples per second. Omitted without audio.
cdn_url
string
CdnUrl provides the URL from the Storage CDN configuration. Omitted without a configured CDN or after file expiry.
expires_at
string
date-time
ExpiresAt specifies when a temporary output expires. Omitted for customer-owned output storage.
height
integer
Height specifies the measured video height in pixels. Omitted for audio-only files.
thumbnail_status
string
ThumbnailStatus reports the optional dashboard preview result. Failure does not affect the media file. Omitted for audio-only files.
Available options:
readyfailed
url
string
Url provides a signed download valid for at most ten minutes. Omitted when the file has expired or signing is unavailable.
video_bitrate
integer
VideoBitrate specifies measured video bits per second, or zero when unavailable. Omitted without video.
video_codec
string
VideoCodec specifies the measured video codec. Omitted for audio-only files.
video_framerate
number
VideoFramerate specifies measured video frames per second. Omitted without video.
width
integer
Width specifies the measured video width in pixels. Omitted for audio-only files.
format
object
required
Format contains the resolved encoding settings accepted at creation, including defaults, dimensions, frame rate and normalized seek and duration. Per-title rate control is resolved during processing. Measured media properties are available in Files.
duration
number
required
Duration specifies the accepted output duration in seconds, including normalized trims.
id
string
required
Id specifies the resolved container and codec selection.
Available options:
mp4_h264mp4_h265mp4_av1webm_vp9m4a_aac
seek
number
required
Seek specifies the accepted start position in source seconds, normalized to the output timeline.
Required range: x >= 0
audio_bitrate
integer
AudioBitrate specifies the resolved audio bitrate in bits per second. Omitted for video-only output.
Required range: 32000 <= x <= 512000
audio_samplerate
integer
AudioSamplerate specifies the resolved audio samples per second. Omitted for video-only output.
Required range: 8000 <= x <= 96000
bufsize
integer
Bufsize specifies the resolved video buffer size in bits, including codec-level defaults. Omitted when no buffer applies.
Required range: 1 <= x <= 5e+07
channels
integer
Channels specifies the resolved audio channel count: 1, 2, 6 or 8. Omitted for video-only output.
Required range: 1 <= x <= 8
cpu_used
string
CpuUsed specifies the accepted VP9 encoder speed setting from 0 through 8. Omitted for other codecs.
crf
integer
Crf specifies the accepted constant quality. Omitted for bitrate-controlled, per-title and audio-only encoding.
Required range: 0 <= x <= 63
disable_audio
boolean
DisableAudio is true for video-only output. Omitted when audio is selected.
framerate
number
Framerate specifies the resolved video frames per second. Omitted for audio-only output.
Required range: 0.001 <= x <= 240
gop
integer
Gop specifies the resolved maximum keyframe interval in frames. Omitted for audio-only output.
Required range: 1 <= x <= 960
height
integer
Height specifies the resolved video height in pixels. Omitted for audio-only output.
Required range: 2 <= x <= 7680
level
integer
Level specifies the accepted codec level when explicitly selected.
maxrate
integer
Maxrate specifies the resolved maximum video bitrate in bits per second, including codec-level defaults. Omitted when no maximum applies.
Required range: 1 <= x <= 1e+08
minrate
integer
Minrate specifies the accepted minimum video bitrate in bits per second, when configured.
Required range: 1 <= x <= 5e+07
movflags
string
Movflags specifies MP4 packaging. MP4 video exports use faststart.
per_title
boolean
PerTitle specifies whether video rate control is selected during content analysis. Omitted for audio-only output.
pixfmt
string
Pixfmt specifies the accepted video pixel format. Omitted for audio-only output.
preset
string
Preset specifies the accepted codec preset. Omitted when the codec does not use presets.
profilev
string
Profilev specifies the accepted codec profile when explicitly selected.
quality
string
Quality specifies the accepted VP9 deadline policy: good, best or realtime. Omitted for other codecs.
video_bitrate
integer
VideoBitrate specifies the accepted video bitrate in bits per second. Omitted for CRF and per-title encoding.
Required range: 1 <= x <= 1e+08
width
integer
Width specifies the resolved video width in pixels. Omitted for audio-only output.
Required range: 2 <= x <= 7680
id
string
required
Id uniquely identifies the Transcoding.
metadata
object
required
Metadata contains the string values attached to the Transcoding.
status
string
required
Status is ready only after the output is validated and published. Temporary output becomes expired when its files are no longer available.
Available options:
preparingreadyfailedcancelledexpired
storage
object
required
Storage contains the resolved output destination.
id
string
required
Id identifies the output Storage.
path
string
required
Path specifies the output file path relative to the Storage base_prefix saved at creation.
updated_at
string
date-time
required
UpdatedAt specifies when the request was last updated.
created_by_token_id
string
CreatedByTokenId specifies the Project token used to create the resource. It remains set after the token is revoked.
Omitted for dashboard requests, MCP OAuth connections, Workflow actions, and unknown creators.
Examples:
tok_2G6MJiNz71bHQGNzGwKx5cJwPFS
created_by_user_id
string
CreatedByUserId specifies the team member who created the resource.
Omitted for Workflow actions, unknown creators, and deleted accounts.
Examples:
u_2G6MJiNz71bHQGNzGwKx5cJwPFS
created_via
string
CreatedVia specifies how the resource was created: api for API requests, dashboard for the Chunkify dashboard, mcp for MCP clients, and workflow for Workflow actions.
Omitted when the creator is unknown.
Available options:
apidashboardmcpworkflow
Examples:
api
delete_at
string
date-time
DeleteAt specifies when this record is deleted: three days after its temporary output expires, otherwise when the team's data retention period ends, counted from when the request was accepted, and no sooner than three days after it finished. It does not delete files in customer-owned Storage. Omitted while the Transcoding is preparing.
error
object
Error describes why processing failed. Omitted when no processing error exists.
code
string
required
Code identifies the processing failure.
message
string
required
Message describes the failure without internal worker or provider diagnostics.
stage
string
required
ProcessingStage specifies the current preparation activity. queued means the request is waiting for processing capacity.
Available options:
queuedstartingencodingfinalizinguploading
expires_at
string
date-time
ExpiresAt specifies when temporary output files expire. Omitted for customer output Storage and before the Transcoding is ready.
processing_stage
string
ProcessingStage specifies the current preparation activity. queued means the request is waiting for processing capacity.
Available options:
queuedstartingencodingfinalizinguploading
progress
number
Progress specifies the video encoding percentage. Available once processing starts and after the output is ready. Omitted for audio-only output; 100 requires published output.
Required range: 0 <= x <= 100
ready_at
string
date-time
ReadyAt specifies when the output was published. Omitted before the Transcoding is ready.
source_id
string
SourceId identifies the original Source. Omitted after Source deletion.
status
"success"
string
required
Status is success for a successful request.
Transcoding accepted for processing.
application/json
error
object
required
code
400
integer
required
Code is the HTTP status code
Examples:
400
message
string
required
Message is a human-readable error description
Examples:
Invalid request parameters
type
"ValidationError"
string
required
Type indicates the error category
Available options:
ValidationError
status
"error"
string
required
Status indicates the response status "error"
The request, Source or output destination is invalid or unavailable.
application/json
error
object
required
Error response details
code
401
integer
required
Code is the HTTP status code
Examples:
401
message
string
required
Message is a human-readable error description
Examples:
Authentication error: invalid token or subscription inactive
type
"AuthenticationError"
string
required
Type indicates the error category
Available options:
AuthenticationError
status
"error"
string
required
Status indicates the response status "error"
Authentication error
application/json
error
object
required
Error response details
code
403
integer
required
Code is the HTTP status code
Examples:
403
message
string
required
Message is a human-readable error description
Examples:
Unauthorized to perform this action
type
"ForbiddenError"
string
required
Type indicates the error category
Available options:
ForbiddenError
status
"error"
string
required
Status indicates the response status "error"
Processing is blocked by the subscription, source-size limit or available credit.
application/json
error
object
required
Error response details
code
429
integer
required
Code is the HTTP status code
Examples:
429
message
string
required
Message is a human-readable error description
Examples:
Rate limit exceeded
type
"TooManyRequestsError"
string
required
Type indicates the error category
Available options:
TooManyRequestsError
status
"error"
string
required
Status indicates the response status "error"
The request rate or team limit of 1000 unfinished Transcodings has been reached.