Add a hook to a clip

Burns a hook (large text over the first seconds) into the clip and re-renders it. Without text, the AI writes one from the clip (same generator as the editor's AI Hook). Styled like the editor's hook (white, boxed, animated). Versioned: the original clip is kept, so a new call replaces the hook. No video quota. Requires write scope.

post/jobs/{id}/clips/{index}/hook

Request

  • Base URL: https://katto.tech/api/v1
  • URL: https://katto.tech/api/v1/jobs/{id}/clips/{index}/hook
  • Auth: HTTP bearer

Path parameters

idstring uuid required
indexinteger required

0-based clip index (position in the job's clips).

Request body

textstring
position'top' | 'center'
durationnumber

Response

Re-render queued

rerender_idstring
status'queued'
status_urlstring uri

Poll GET /jobs/{id}/rerenders/{rerender_id}.

hook_textstring
generatedboolean

true when the AI wrote the hook.

Changes

No recorded changes to this operation across all 1 revision of this API.