katto_add_hook
Add bold text over a clip's opening seconds to stop the scroll and re-render it. Pass your own hook or let AI write one, then poll for the new clip URL.
Instructions
Add a hook, big bold text over the first seconds that stops the scroll, to one finished clip and re-render it. Pass text to use your own (max 80 characters, 3-7 words reads best) or omit it and Katto's AI writes one from the clip in its language. position: top (default) or center; duration: 1-10 s (default 4). Styled like the editor's AI Hook (white, boxed, pop-in). Does NOT use video quota; the original clip is kept. Not idempotent: each call starts a new render, and a re-render starts from the original clip, so calling it again replaces the hook rather than stacking two. Returns { rerender_id, hook_text, generated, status_url }; poll katto_get_rerender for the new clip_url.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Job id. | |
| text | No | The hook to display (max 80 characters; 3-7 words reads best). Omit to let Katto write one from the clip. | |
| duration | No | How many seconds the hook stays on screen, 1-10 (default 4). | |
| position | No | Where the hook sits on the frame (default top). | |
| clip_index | Yes | 0-based clip index. |