Make a faceless video
create_videoMake a faceless video without filming or uploading footage. Supply exactly one of idea (Clypmint writes the narration) or script (spoken exactly as supplied). Defaults to a 30-second vertical video; seconds may be 15, 30 or 60. An exact script sets its own length at about 2.5 words a second (at most 172 words for 60 s); leave seconds out with a script and the shortest length that fits is used, and a script too long is refused at once with the word count. Uses the selected style’s pictures, designed screens, captions and sound, with the linked account’s existing credits and limits. Style: inspect browse_styles and its actual inputs. Serif Editorial Launch is format: motion with inputs.voice:none by default; Bold Navy Statement is narrated faceless with Chris as its style default. An explicit voiceover request adds narration to motion while keeping its visuals and aligning them to the recorded speech. Other faceless styles or ready saved copies remain available. A style marked format: talking is made for someone on camera. Optional: style_id (with style_version for a saved style of your own), formats (9:16, 16:9, 1:1, 4:5; first is the main one), voice (one of 21 narrators by name; omitted, preserve the style’s voice default, including none for motion; "Voice: " in instructions works too), sound_effects (on unless false), music_bed (the style’s music under the voice, only when true), purpose, instructions up to 8,000 characters, asset_ids from list_assets, asset_staging_keys from import_asset (logo: true for the brand’s logo), and music_staging_key from import_asset. Cost: 3 credits to make, plus 1 for each started minute of voice-over and 1 for each started minute of finished video after the first, plus 2 for each extra format; dry_run: true answers the cost and starts nothing. For several videos at once use create_videos; for a month of posts use plan_content. Return the studio_url and call check_video with video_id for progress and the finished download. Preserve operation_id and arguments on retries; never publish unless separately requested.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| idea | No | ||
| title | No | ||
| voice | No | The narrator for a video made from words: matilda, sarah, jessica, alice, liam, chris, brian, george, roger, laura, charlie, river, will, eric, bella, daniel, lily, bill, adam, callum, harry (sarah: calm, reassuring, health and money; alice: a clear British educator; brian: deep documentary; liam: energetic ads). Leave out to let Clypmint pick one that fits the words. "Voice: <name>" in instructions does the same. | |
| format | No | vertical | |
| script | No | ||
| dry_run | No | true: answer the credit cost and start nothing. | |
| formats | No | Every shape to make, the main one first: 9:16, 16:9, 1:1, 4:5. | |
| purpose | No | organic (a post), ad (three openings by default), youtube (horizontal), sales_page. | |
| seconds | No | How long: 15, 30 or 60. With a script, leave it out: the script sets the length (about 2.5 words a second; at most 43 words for 15, 86 for 30, 172 for 60). | |
| style_id | No | ||
| asset_ids | No | ||
| music_bed | No | true: lay the style's own music bed under the narration (none unless asked); false: never. music_staging_key brings a song of your own instead. | |
| instructions | No | Anything else the user asked for, in their own words: where each picture goes, the tone. Length, narrator, pictures and shapes go in their own fields. No rule lists. A link written here is not opened: import a picture first with import_asset. | |
| operation_id | Yes | ||
| sound_effects | No | ||
| style_version | No | ||
| music_staging_key | No | A song from import_asset (mp3, wav or m4a) to lay under the voice. | |
| asset_staging_keys | No | Pictures the user wants shown (a portrait, a product shot, an app screen): import each with import_asset (its url) and list the keys here. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | ||
| cost | No | ||
| error | No | ||
| state | No | ||
| status | No | ||
| dry_run | No | ||
| message | No | ||
| plan_id | No | ||
| style_id | No | ||
| video_id | No | ||
| available | No | ||
| import_id | No | ||
| output_id | No | ||
| studio_url | No | ||
| version_id | No |