asset.output.ready
Payload recorded when an output becomes available.
asset.output.ready is recorded when an output becomes available. data.output contains the same typed output object returned by the Asset outputs API. Its type identifies a transcript, caption, static rendition, or thumbnail request, and details contains that resource's snapshot.
The output's id uses the shared aop_ prefix for every Asset output type. Its asset_id identifies the owning Asset. Standalone thumbnail resources use thm_ IDs and the separate thumbnail.* event family.
Each output becomes ready independently. A ready output does not mean all other outputs on the Asset are ready. Transcript snapshots include the full text and timed segments in details.content. Media snapshots include their available delivery URLs. Retrieve the output for current state and fresh signed URLs.
Payload for Asset output creation, readiness, and failure events.
Output contains the canonical typed output snapshot at the event time, matching the output API.
An Asset-owned caption output and its canonical resource details.
AssetId identifies the owning Asset.
Details contains the canonical typed output resource, including its available delivery fields.
Unique Asset output ID, prefixed with aop_.
Caption processing status.
preparingreadyfailedexpiredTime this caption output was requested.
Reason caption processing failed.
Machine-readable processing error code.
Description of the processing failure.
Processing stage that failed.
ingestanalysisencodingpackaginguploadvalidationcleanupPrimary language of this subtitle track, such as en or fr. Omitted when no speech was detected or processing has not finished.
Subtitle media playlist path in Storage. Available when speech was detected.
Combined subtitle playlist and WebVTT size in bytes. Available when ready.
x >= 0ID of the caption track translated to create this track. Omitted for speech transcription.
TranscriptId identifies the original-language transcript used to generate this caption. Omitted for translated captions.
WebVTT subtitle segment path in Storage. Available when speech was detected.
Id identifies the Asset output, prefixed with aop_. The type field identifies the output kind.
Status specifies the output processing state. Expired means temporary output files are no longer available.
preparingreadyfailedexpiredType identifies the output kind.
An Asset-owned static rendition output and its canonical resource details.
AssetId identifies the owning Asset.
Details contains the canonical typed output resource, including its available delivery fields.
Parent Asset ID.
Media container.
When the rendition was created.
Output height in pixels.
x >= 0Unique Asset output ID, prefixed with aop_.
MP4 path in Storage. Recreating the same resolution reuses this path and overwrites any retained file.
Requested resolution selector.
highest240p360p480p540p720p1080p1440p2160pSelected output resolution. May be smaller than 240p for small sources. Use width and height for pixel dimensions.
Processing status of this MP4, independent of streaming outputs.
preparingreadyfailedexpiredStorage containing this rendition, inherited from its Asset.
When the rendition was last updated.
Video codec.
Output width in pixels.
x >= 0Measured audio bitrate in bits per second. Omitted until known or when there is no audio.
x >= 0Measured audio codec. Omitted until known or when there is no audio.
Measured audio sample rate in Hz. Omitted until known or when there is no audio.
x >= 0Unsigned MP4 CDN URL. Available when ready and unexpired and Storage has a CDN URL.
Output duration in seconds. Omitted until ready.
x >= 0Machine-readable processing error code.
Description of the processing failure.
Processing stage that failed.
ingestanalysisencodingpackaginguploadvalidationcleanupProgress specifies the current processing stage and encoding percentage. Omitted after processing ends.
Stage specifies the current preparation activity. Finalization and streaming publication can overlap encoding; finalizing is shown once encoding has completed.
queuedstartingencodingfinalizinguploadingPercent specifies the percentage of the video encoded so far. Present only during encoding when video duration is known. It may decrease if processing restarts. It does not estimate total preparation time.
0 <= x <= 100When the MP4 became available.
File size in bytes. Omitted until ready.
x >= 0Signed MP4 download URL, available when ready and unexpired. Valid for up to ten minutes. Retrieve the output to refresh it. Independent of preview_enabled.
Measured video bitrate in bits per second. Omitted until ready.
x >= 0Measured video frame rate in frames per second. Omitted until known.
x >= 0Id identifies the Asset output, prefixed with aop_. The type field identifies the output kind.
Status specifies the output processing state. Expired means temporary output files are no longer available.
preparingreadyfailedexpiredType identifies the output kind.
An Asset-owned thumbnail output and its canonical resource details.
AssetId identifies the owning Asset.
Details contains the canonical typed output resource, including its available delivery fields.
AssetId identifies the owning Asset for Workflow outputs, or null for standalone requests.
CreatedAt records when the request was accepted.
Files contains all published images or sheets and the WebVTT index. Empty while preparing.
Kind identifies an individual image, sprite sheet, or WebVTT index.
imagespritevttPath specifies the file relative to storage_prefix.
Size specifies the measured encoded file size in bytes.
x >= 1CdnUrl provides delivery through the configured CDN. Omitted without a CDN or after expiry.
Height specifies the measured image or complete sprite canvas height. Omitted for WebVTT.
x >= 1Url provides temporary authorized delivery. Omitted after expiry or when unavailable.
Width specifies the measured image or complete sprite canvas width. Omitted for WebVTT.
x >= 1Id identifies this thumbnail request. Standalone requests use thm_ IDs; Asset-owned outputs use aop_ IDs.
thm_exampleMetadata contains the accepted string metadata.
Samples contains published thumbnails ordered by timestamp. Empty while preparing. A ready resource may contain fewer samples than requested.
Height specifies this image or tile height in pixels.
x >= 1Path identifies the image or sprite sheet in files.
Timestamp specifies the measured Source-relative presentation time of the selected frame in seconds. Compatible cached inputs use millisecond timestamps, which can select a neighboring frame compared with the original Source.
x >= 0Width specifies this image or tile width in pixels.
x >= 1Crop specifies the tile origin in its sprite sheet. Omitted for individual images; width and height give the tile dimensions.
X specifies the left edge in pixels.
x >= 0Y specifies the top edge in pixels.
x >= 0Settings contains the accepted sampling and output settings.
Format specifies the image encoding.
jpegwebpOutput specifies individual images or automatically arranged sprite sheets.
imagesspritesRange contains the accepted sampling boundaries.
End specifies the exclusive upper bound in seconds.
Start specifies the inclusive lower bound in seconds.
x >= 0Size specifies the accepted maximum image or tile edge in pixels.
64 <= x <= 1920Timestamps specifies 1 to 100 Source-relative target times in seconds. Every time must be within the selected range. Repeated targets produce separate outputs.
Count specifies 1 to 100 thumbnails at the middle of equal sections of the selected range.
1 <= x <= 100Count specifies 1 to 100 thumbnails at the middle of equal sections of the selected range.
1 <= x <= 100Format specifies the image encoding.
jpegwebpOutput specifies individual images or automatically arranged sprite sheets.
imagesspritesRange contains the accepted sampling boundaries.
End specifies the exclusive upper bound in seconds.
Start specifies the inclusive lower bound in seconds.
x >= 0Size specifies the accepted maximum image or tile edge in pixels.
64 <= x <= 1920Timestamps specifies 1 to 100 Source-relative target times in seconds. Every time must be within the selected range. Repeated targets produce separate outputs.
SourceId identifies the input Source, or null if it has been deleted.
Status is ready only after processing and publication finish. Temporary outputs become expired after their retention period.
preparingreadyfailedexpiredStorageId identifies the accepted output Storage.
StoragePath specifies the accepted filename template relative to the Storage base_prefix, or null when Chunkify generated the file names.
StoragePrefix specifies the complete output folder saved at creation. File and sample paths are relative to this folder.
UpdatedAt records the last lifecycle update.
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.
tok_2G6MJiNz71bHQGNzGwKx5cJwPFSCreatedByUserId specifies the team member who created the resource. Omitted for Workflow actions, unknown creators, and deleted accounts.
u_2G6MJiNz71bHQGNzGwKx5cJwPFSCreatedVia 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.
apidashboardmcpworkflowapiDeleteAt specifies when this standalone request 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 preparing and for Asset-owned thumbnails, which follow their Asset.
Error explains a failed request. Omitted otherwise.
Code identifies the processing failure.
Message explains the processing failure.
ExpiresAt specifies when temporary output files expire. Omitted for customer output Storage.
ReadyAt records when the complete available set was published. Omitted before publication.
Id identifies the Asset output, prefixed with aop_. The type field identifies the output kind.
Status specifies the output processing state. Expired means temporary output files are no longer available.
preparingreadyfailedexpiredType identifies the output kind.
An Asset-owned transcript output and its content.
AssetId identifies the owning Asset.
Id identifies the Asset output, prefixed with aop_.
Status specifies the output processing state. Expired means temporary output files are no longer available.
preparingreadyfailedexpiredContent contains the complete text and timed segments. Included when ready; omitted while preparing, failed or expired.
Segments contains timed passages in chronological order. Individual word timestamps are not included.
End specifies the passage end time in seconds.
x >= 0Start specifies the passage start time in seconds.
x >= 0Text contains the recognized passage, including punctuation.
Text contains the complete recognized speech in the original language.
Machine-readable processing error code.
Description of the processing failure.
Processing stage that failed.
ingestanalysisencodingpackaginguploadvalidationcleanupLanguageCode identifies the detected primary language, such as en. Omitted before recognition or when no speech is detected.
Id identifies the Asset output, prefixed with aop_.
Status specifies the output processing state. Expired means temporary output files are no longer available.
preparingreadyfailedexpiredType identifies the output kind.