Create a short / reel (async)
create_shortStart making vertical 9:16 short(s) from a video link or an upload. Returns project ids immediately — rendering takes ~2–10 min; then call wait_for_project or get_project until status is "complete" and share videoUrl. tool=story (8 credits each): AI story script + natural voiceover + best footage + animated captions + headline — talent-show auditions, animals, sports, satisfying, wholesome, food, kids. tool=transformation (14 credits each): haircut/makeover suspense story with a BEFORE/AFTER reveal (faces blurred or hidden). tool=clips (3 credits each): best moment with the ORIGINAL audio, captions, headline and music. Pass template_id to apply a niche template's defaults (tool is then optional). Credits are charged now and refunded automatically if the job fails. Use urls for a batch (up to the plan's batch limit).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Public video link (YouTube, TikTok, Instagram, Facebook, X, Vimeo…). | |
| hook | No | Start with an AI hook / cold open. | |
| name | No | Project name (default: the source title). | |
| tool | No | Which short to make (default: the template's tool, else story). | |
| urls | No | Several links → one short per link (batch). | |
| genre | No | Story genre for the script (story/transformation). | |
| music | No | "auto" (AI picks royalty-free music by mood), "none", or a Brand Kit music asset id. | |
| headline | No | Animated headline card on top (default true). | |
| language | No | Language of script, voiceover, captions and headline (default: the account's preference or en). | |
| voice_id | No | Narrator voice id (list_voices); story/transformation. | |
| upload_id | No | Id of a file uploaded with POST /api/v1/uploads. | |
| ending_cta | No | Story: end with "Full video below". | |
| reveal_mode | No | Transformation: show the reveal with faces blurred, or hide it (cliffhanger). | |
| template_id | No | Niche template (list_templates) — presets genre, length, captions, music mood, hook. | |
| caption_style | No | Caption style id (list_caption_styles). | |
| headline_text | No | Custom headline text (otherwise the AI writes it). | |
| target_seconds | No | Target length in seconds (15–60). | |
| 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. |