Skip to main content
Glama

Make a faceless video

create_video
DestructiveIdempotent

Use this for a new faceless video (the style’s pictures, designed screens, captions and sound) from an idea or a script, with no footage. Not for footage (edit_video) or a video already made (apply_document). Send exactly one of idea (Clypmint writes the narration) or script (spoken exactly as supplied), which sets the length, so leave seconds out. Defaults to a 30-second vertical video; seconds 10 to 60. style_id only when they name one or their own fits; every style can make a video from words, in its own look; its inputs are presets: Serif Editorial Launch has inputs.voice:none (no narrator unless the user asks for a voiceover); Bold Navy Statement is narrated, with Chris by default. Optional: sound_effects (on unless false), music_bed (only when true), formats (the main shape first), voice (one of 21 narrators by name), pictures, a song, purpose, instructions. 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. Answers with studio_url: follow it with check_video. It does not post.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "operation_id": "<operation_id>"
    },
    "name": "create_video"
  }
}

Input Schema

NameRequiredDescriptionDefault
ideaNoWhat the video is about, in a line or two: Clypmint writes the narration.
titleNoThe video's name in the user's library.
voiceNoThe narrator (sarah: calm, health and money; alice: clear British educator; brian: deep documentary; liam: energetic ads). Left out: one that fits.
formatNoThe older one-shape switch; formats says more.vertical
scriptNoThe exact words to narrate, read as written. Send script or idea, not both.
dry_runNotrue: answer the credit cost and start nothing.
formatsNoEvery shape to make, the main one first: 9:16, 16:9, 1:1, 4:5.
purposeNoorganic (a post), ad (three openings by default), youtube (horizontal), sales_page.
secondsNoAny length, 10 to 60. With a script, leave it out: the script sets the length (about 2.5 words a second).
style_idNoOnly one they named or their own (get_profile own_styles).
asset_idsNoPictures or clips already in Clypmint to show (src_... from list_assets or save_clip).
music_bedNotrue: 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.
instructionsNoAnything else the user asked for, in their own words. A link here is not opened: use import_asset.
operation_idYesSame id retries run once.
sound_effectsNoSound effects: on unless false.
style_versionNoA saved version of the user's own style; its newest when left out.
music_staging_keyNoA song from import_asset (mp3, wav or m4a) to lay under the voice.
asset_staging_keysNoPictures the user wants shown (a portrait, a product, an app screen), each imported with import_asset.

Output Schema

NameRequiredDescriptionDefault
codeNo
costNo
errorNo
stateNo
statusNo
dry_runNo
messageNo
plan_idNo
style_idNo
video_idNo
availableNo
import_idNo
output_idNo
studio_urlNo
version_idNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changed
    • removedInput schema / properties / asset_ids / items / pattern
      Removed value: -"^src_[A-Za-z0-9][A-Za-z0-9_-]{7,95}$"
    • removedInput schema / properties / asset_staging_keys / items / pattern
      Removed value: -"^stg_[A-Za-z0-9][A-Za-z0-9_-]{7,95}$"
    • removedInput schema / properties / music_staging_key / pattern
      Removed value: -"^stg_[A-Za-z0-9][A-Za-z0-9_-]{7,95}$"
    • removedInput schema / properties / operation_id / pattern
      Removed value: -"^[a-zA-Z0-9_.:-]{1,100}$"
    • removedInput schema / properties / style_id / pattern
      Removed value: -"^[a-z0-9-]{1,40}$"
  2. Added
  3. Removed
  4. Changed5 schema fields changed
    • changedInput schema / properties / seconds / description
      Previous value: -"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)."New value: +"Any length, 10 to 60. With a script, leave it out: the script sets the length (about 2.5 words a second)."
    • removedInput schema / properties / seconds / enum
      Removed value: -[
      -  15,
      -  30,
      -  60
      -]
    • addedInput schema / properties / seconds / maximum
      Added value: +60
    • addedInput schema / properties / seconds / minimum
      Added value: +10
    • changedInput schema / properties / seconds / type
      Previous value: -"number"New value: +"integer"
  5. Changed3 schema fields changed
    • changedInput schema / properties / instructions / description
      Previous value: -"Anything else the user asked for, in their own words (where each picture goes, the tone); not what has its own field, and no rule lists. A link here is not opened: import a picture with import_asset."New value: +"Anything else the user asked for, in their own words. A link here is not opened: use import_asset."
    • changedInput schema / properties / operation_id / description
      Previous value: -"A retry with the same id runs once."New value: +"Same id retries run once."
    • changedInput schema / properties / voice / description
      Previous value: -"The narrator for a video made from words (sarah: calm, health and money; alice: clear British educator; brian: deep documentary; liam: energetic ads). Left out: the style's own narrator, or one that fits the words."New value: +"The narrator (sarah: calm, health and money; alice: clear British educator; brian: deep documentary; liam: energetic ads). Left out: one that fits."
  6. Changed2 schema fields changed
    • changedInput schema / properties / style_id / description
      Previous value: -"A style id from browse_styles (my-... for the user's own)."New value: +"Only one they named or their own (get_profile own_styles)."
    • changedInput schema / properties / voice / description
      Previous value: -"The narrator for a video made from words (sarah: calm, health and money; alice: clear British educator; brian: deep documentary; liam: energetic ads; browse_styles describes all 21). Left out: the style's own narrator, or one that fits the words."New value: +"The narrator for a video made from words (sarah: calm, health and money; alice: clear British educator; brian: deep documentary; liam: energetic ads). Left out: the style's own narrator, or one that fits the words."
  7. Changed1 schema field changed
    • changedInput schema / properties / operation_id / description
      Previous value: -"The same id on a retry runs it once; a new id is a new request."New value: +"A retry with the same id runs once."
  8. Changed16 schema fields changed
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • addedInput schema / properties / asset_ids / description
      Added value: +"Pictures or clips already in Clypmint to show (src_... from list_assets or save_clip)."
    • changedInput schema / properties / asset_staging_keys / description
      Previous value: -"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."New value: +"Pictures the user wants shown (a portrait, a product, an app screen), each imported with import_asset."
    • addedInput schema / properties / format / description
      Added value: +"The older one-shape switch; formats says more."
    • addedInput schema / properties / idea / description
      Added value: +"What the video is about, in a line or two: Clypmint writes the narration."
    • changedInput schema / properties / instructions / description
      Previous value: -"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."New value: +"Anything else the user asked for, in their own words (where each picture goes, the tone); not what has its own field, and no rule lists. A link here is not opened: import a picture with import_asset."
    • addedInput schema / properties / operation_id / description
      Added value: +"The same id on a retry runs it once; a new id is a new request."
    • addedInput schema / properties / script / description
      Added value: +"The exact words to narrate, read as written. Send script or idea, not both."
    • removedInput schema / properties / seconds / anyOf
      Removed value: -[
      -  {
      -    "const": 15,
      -    "type": "number"
      -  },
      -  {
      -    "const": 30,
      -    "type": "number"
      -  },
      -  {
      -    "const": 60,
      -    "type": "number"
      -  }
      -]
    • addedInput schema / properties / seconds / enum
      Added value: +[
      +  15,
      +  30,
      +  60
      +]
    • addedInput schema / properties / seconds / type
      Added value: +"number"
    • addedInput schema / properties / sound_effects / description
      Added value: +"Sound effects: on unless false."
    • addedInput schema / properties / style_id / description
      Added value: +"A style id from browse_styles (my-... for the user's own)."
    • addedInput schema / properties / style_version / description
      Added value: +"A saved version of the user's own style; its newest when left out."
    • addedInput schema / properties / title / description
      Added value: +"The video's name in the user's library."
    • changedInput schema / properties / voice / description
      Previous value: -"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."New value: +"The narrator for a video made from words (sarah: calm, health and money; alice: clear British educator; brian: deep documentary; liam: energetic ads; browse_styles describes all 21). Left out: the style's own narrator, or one that fits the words."
  9. Changed2 schema fields changed
    • addedInput schema / properties / asset_staging_keys / description
      Added value: +"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."
    • changedInput schema / properties / instructions / description
      Previous value: -"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."New value: +"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."
  10. Changed2 schema fields changed
    • addedInput schema / properties / instructions / description
      Added value: +"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."
    • addedInput schema / properties / seconds / description
      Added value: +"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)."
  11. Changed2 schema fields changed
    • addedInput schema / properties / music_bed
      Added value: +{
      +  "description": "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.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / voice / description
      Previous value: -"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. Leave out to let Clypmint pick one that fits."New value: +"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."
  12. Changed1 schema field changed
    • changedInput schema / $schema
      Previous value: -"https://json-schema.org/draft/2020-12/schema"New value: +"http://json-schema.org/draft-07/schema#"
  13. Changed2 schema fields changed
    • changedInput schema / properties / voice / description
      Previous value: -"The narrator for a video made from words: matilda, sarah, jessica, alice, liam, chris, brian, george. Leave out to let Clypmint pick one that fits."New value: +"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. Leave out to let Clypmint pick one that fits."
    • changedInput schema / properties / voice / enum
      Previous value: -[
      -  "matilda",
      -  "sarah",
      -  "jessica",
      -  "alice",
      -  "liam",
      -  "chris",
      -  "brian",
      -  "george"
      -]New value: +[
      +  "matilda",
      +  "sarah",
      +  "jessica",
      +  "alice",
      +  "liam",
      +  "chris",
      +  "brian",
      +  "george",
      +  "roger",
      +  "laura",
      +  "charlie",
      +  "river",
      +  "will",
      +  "eric",
      +  "bella",
      +  "daniel",
      +  "lily",
      +  "bill",
      +  "adam",
      +  "callum",
      +  "harry"
      +]
  14. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "description": "Clypmint create_video result. Error results carry error; successful requests expose the identifiers and state available for the next step. Signed media stays in private metadata.",
      +  "properties": {
      +    "available": {
      +      "type": "boolean"
      +    },
      +    "code": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "cost": {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    "dry_run": {
      +      "type": "boolean"
      +    },
      +    "error": {
      +      "type": "string"
      +    },
      +    "import_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "message": {
      +      "type": "string"
      +    },
      +    "output_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "plan_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "state": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "status": {
      +      "type": [
      +        "string",
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "studio_url": {
      +      "format": "uri",
      +      "type": "string"
      +    },
      +    "style_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "version_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "video_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  15. Changed7 schema fields changed
    • addedInput schema / properties / dry_run
      Added value: +{
      +  "description": "true: answer the credit cost and start nothing.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / formats
      Added value: +{
      +  "description": "Every shape to make, the main one first: 9:16, 16:9, 1:1, 4:5.",
      +  "items": {
      +    "enum": [
      +      "9:16",
      +      "16:9",
      +      "1:1",
      +      "4:5"
      +    ],
      +    "type": "string"
      +  },
      +  "maxItems": 4,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • addedInput schema / properties / music_staging_key
      Added value: +{
      +  "description": "A song from import_asset (mp3, wav or m4a) to lay under the voice.",
      +  "pattern": "^stg_[A-Za-z0-9][A-Za-z0-9_-]{7,95}$",
      +  "type": "string"
      +}
    • addedInput schema / properties / purpose
      Added value: +{
      +  "description": "organic (a post), ad (three openings by default), youtube (horizontal), sales_page.",
      +  "enum": [
      +    "organic",
      +    "ad",
      +    "youtube",
      +    "sales_page"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / sound_effects
      Added value: +{
      +  "type": "boolean"
      +}
    • addedInput schema / properties / style_version
      Added value: +{
      +  "maximum": 10000,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / voice
      Added value: +{
      +  "description": "The narrator for a video made from words: matilda, sarah, jessica, alice, liam, chris, brian, george. Leave out to let Clypmint pick one that fits.",
      +  "enum": [
      +    "matilda",
      +    "sarah",
      +    "jessica",
      +    "alice",
      +    "liam",
      +    "chris",
      +    "brian",
      +    "george"
      +  ],
      +  "type": "string"
      +}
  16. Changed3 schema fields changed
    • addedInput schema / properties / idea
      Added value: +{
      +  "maxLength": 4000,
      +  "minLength": 3,
      +  "type": "string"
      +}
    • addedInput schema / properties / seconds / default
      Added value: +30
    • changedInput schema / required
      Previous value: -[
      -  "script",
      -  "seconds",
      -  "operation_id"
      -]New value: +[
      +  "operation_id"
      +]
  17. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources