Create a clip request
clipember_create_clip_requestStart a new AI clipping job from a YouTube (or direct video file) URL. Spends 1 credit — check clipember_get_credit_balance first if unsure. Returns immediately with a requestId; the pipeline (transcribe → score → crop → render) usually takes about 5 minutes, and about 1 run in 10 takes 15+ minutes. Call clipember_get_clip_request to check progress — don't poll more than once every 30-60 seconds, and expect to need a fresh call in a LATER turn/message rather than waiting synchronously in this one.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Seconds into the source to stop (max ~1200 = 20 min window) | |
| url | Yes | YouTube URL or a direct video file URL | |
| start | No | Seconds into the source to start processing | |
| series | No | If true, make a SERIES: one continuous story from the video split into 2-6 consecutive parts, each ending on a cliffhanger, with 'PART n/N' on screen. Schedule them in order with clipember_schedule_series once rendered. | |
| teaser | No | If true, open each clip with a 1-3 second teaser of its payoff line before the clip starts (a cold open). Not applied to series parts. | |
| language | No | Source language, ISO 639-1 | en |
| watermark | No | Burn a diagonal clipember.com watermark into the rendered clips. Omit to use the account setting (Settings → watermark); pass true/false to override it for this run. | |
| noClipping | No | If true, render ONE clip of the whole [start,end] range instead of finding multiple highlights | |
| preferredLength | No | under60sec |