# estimate_video_timeline_price

Estimate the Creative Units price of a video timeline render without rendering anything.

Author the timeline exactly as for \`render\_video\_timeline\`. Prices through the same estimator the  
render charges against, so the price matches for identical inputs. Returns the price plus the  
workspace balance. Produces no file.

## Parameters

| Parameter                  | Type                      | Default | Description                                                                                                                                                                       |
| -------------------------- | ------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| templaterequired           | TimelineTemplate          | —       | Timeline layout designed in the editor. Tracks, items, timing, and slot references.                                                                                               |
| tracks                     | TimelineTemplateTrack\[\] | —       | Ordered list of tracks in the timeline. Composited in reverse order (Track 1 is on top). Do not overlap items within the same track; use multiple tracks for overlapping content. |
| idrequired                 | string                    | —       | Unique identifier for the track.                                                                                                                                                  |
| namerequired               | string                    | —       | User-facing name of the track.                                                                                                                                                    |
| itemsrequired              | any\[\]                   | —       | Ordered list of items on this track.                                                                                                                                              |
| transitions                | any\[\]                   | —       | Transitions on the seams between adjacent items on this track.                                                                                                                    |
| disabled                   | boolean                   | false   | Whether the track is excluded from rendering.                                                                                                                                     |
| fps                        | integer≤120, >0           | 30      | Frames per second of the output video.                                                                                                                                            |
| width                      | integer2–7680             | 1920    | Width of the output video, in pixels. Must be even.                                                                                                                               |
| height                     | integer2–4320             | 1080    | Height of the output video, in pixels. Must be even.                                                                                                                              |
| codec                      | string                    | h264    | Video codec for encoding the output. Only h264 is supported.                                                                                                                      |
| crf                        | integer0–51               | 18      | Constant Rate Factor controlling output quality. Lower values produce higher quality.                                                                                             |
| max\_duration\_in\_seconds | number≤120, >0            | —       | Maximum allowed duration of the rendered video, in seconds.                                                                                                                       |
| playback\_rate             | number≤4, >0              | 1       | Global playback speed multiplier. 1.0 = normal, 2.0 = double speed, 0.5 = half speed.                                                                                             |
| videos                     | object                    | —       | Slotted video assets. Each slot name matches a slot reference in the timeline template.                                                                                           |
| images                     | object                    | —       | Slotted image assets. Each slot name matches a slot reference in the timeline template.                                                                                           |
| audios                     | object                    | —       | Slotted audio assets. Each slot name matches a slot reference in the timeline template.                                                                                           |
| workspace\_idrequired      | string (uuid)             | —       | The user's workspace id.                                                                                                                                                          |