AI Clipper: analyse a long video (async)
start_clipperAI Clipper step 1/2: analyse a long video (podcast, interview, stream, show) from a link or upload and propose up to max_clips self-contained viral clips. Costs 2 credits per started 30 minutes of source (refunded if it fails). Returns plan_id immediately; analysis takes a few minutes — poll get_clip_plan until status is "ready", then call generate_clips (2 credits per clip).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Public video link (YouTube, TikTok, Instagram, Facebook, X, Vimeo…). | |
| music | No | "none" (default), "auto" or a Brand Kit music asset id. | |
| layout | No | Framing: auto, focus (speaker), general (wide), split (two speakers), screen (screen share). | |
| headline | No | Headline card on each clip (default true). | |
| language | Yes | Language of captions and headlines. | |
| max_clips | Yes | How many clip candidates to find (up to the plan limit). | |
| upload_id | No | Id of a file uploaded with POST /api/v1/uploads. | |
| caption_style | No | Caption style (default highlight_box). | |
| target_seconds | Yes | Target clip length in seconds (15–90). | |
| idempotency_key | No | Optional unique key (e.g. a uuid) — repeating the same call with the same key within 24 h returns the first result instead of charging again. |