Plan script length
plan_script_lengthRead-onlyIdempotent
Use this when the user wants to fit a speech into a target duration. With a target duration and speed, returns how many words to write. With a script and target duration, returns the necessary speed plus words to cut or add at the selected pace. Target duration is 1 second to 24 hours and speed is a whole number from 60 to 300 words per minute. Numeric pause cues accept whole seconds from 1 to 86,400 per cue. Does not rewrite the script.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| speed | No | Named writing pace or whole number from 60 to 300 wpm for the word target or cut/add estimate, e.g. conversational. | |
| script | No | Optional existing script to assess, e.g. Welcome everyone. Thank you for coming. | |
| target_duration_seconds | Yes | Target total duration in seconds, e.g. 300 for five minutes. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| speed_wpm | Yes | ||
| word_change | Yes | ||
| target_words | Yes | ||
| pause_seconds | Yes | ||
| reader_speed_wpm | Yes | ||
| reader_duration_ms | Yes | ||
| necessary_speed_wpm | Yes | ||
| target_duration_seconds | Yes | ||
| necessary_speed_fraction | Yes |