Read an asset
read_assetRead an uploaded asset's pixels, metadata and readiness, and its analysis: every upload is analyzed after it encodes, and analysis.brief then says what happens, what is on screen and heard, the moments to use or cut (with times), the lines worth quoting, and the problems; the sound's music, effects and reactions with times. hasAudio says whether a video has a sound track. id comes from search_assets. To look closely at a video file, whether or not it is on the film (preview_frame and preview_range draw only the film): startSeconds and endSeconds draw a contact sheet of only that range of the file, and times draws up to 4 frames of the file large. Use them to time an action to a tenth of a second or to check a detail. Such a call answers with the picture and its legend, not the brief.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| times | Yes | Seconds of a video file to see as large frames, 1 to 4, in one picture in time order with each time on its frame. Use it to check a detail or the exact moment of an action. Not with startSeconds and endSeconds. null (or leaving it out) draws a contact sheet. | |
| projectId | Yes | The project this call runs on without changing the open project. null (or leaving it out) uses the open project. wait_for_jobs takes the projectId of the calls that started the jobs. | |
| endSeconds | Yes | Where that range ends, in seconds of the file, after startSeconds. The sheet has up to 16 tiles with their times, so a range of 2 seconds shows a tile about every 0.13 seconds. A range past the end of the file stops at its end. | |
| startSeconds | Yes | Where a contact sheet of part of a video starts, in seconds of the file. Pass it with endSeconds. null (or leaving it out) draws the whole file. |