studio.add_scene_from_asset
Append an uploaded video or image asset to the main track as a finished scene, or insert it at at_index. Assets longer than 10 minutes become consecutive scenes. A video with no measured length lands as one untrimmed 5s scene marked length_estimated: true, here and in get_composition, until the file is measured in the studio editor. Audio assets are refused; use add_audio_to_timeline.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asset_id | Yes | A video or image asset id (vas_...) from get_composition's assets list. | |
| at_index | No | 0-based position in scene order; appends when omitted. | |
| project_id | Yes | The studio project (vp_…) this tool acts on. |