Clip Studio MCP

Previous value: -"Account email, when known."New value: +"Account email, or null when unknown."

Previous value: -"string"New value: +[
+  "string",
+  "null"
+]

Previous value: -"ISO timestamp when the monthly allowance resets, when known."New value: +"ISO timestamp when the monthly allowance resets, or null when there is no reset window (no period, unlimited operator, or unknown)."

Previous value: -"string"New value: +[
+  "string",
+  "null"
+]

Previous value: -"Image Lab model slug from list_image_lab_models (gpt-image-2-5, nano-banana, nano-banana-2, nano-banana-pro, flux-2-pro, mai-image-2-5, mai-image-2-5-pro, seedream-5-lite, muse-image, grok-imagine-image-2, qwen-image-3, kling-image-o3, flux-3-image, ideogram-v4-5, seedream-5-flash, recraft-v4-1-flash)."New value: +"Image Lab model slug from list_image_lab_models (gpt-image-2-5, nano-banana, nano-banana-2, nano-banana-2-1, nano-banana-pro, flux-2-pro, mai-image-2-5, mai-image-2-5-pro, seedream-5-lite, muse-image, grok-imagine-image-2, qwen-image-3, kling-image-o3, flux-3-image, ideogram-v4-5, seedream-5-flash, recraft-v4-1-flash)."

Added value: +{
+  "description": "Optional AI hook: the opening shot is an AI clip and abstract beats can get AI stills; the rest stays judged stock. Quoted higher. Any AI shot that misses its 2-minute deadline falls back to the best stock clip. Not available on the free short.",
+  "type": "boolean"
+}

Previous value: -"Frame size. 9:16 vertical (default) or 16:9 landscape."New value: +"Frame size. 9:16 vertical (default), 16:9 landscape, or 1:1 square for feeds."

Previous value: -[
-  "9:16",
-  "16:9"
-]New value: +[
+  "9:16",
+  "16:9",
+  "1:1"
+]

Added value: +{
+  "description": "auto (default) keeps one recurring fictional character consistent across shots on story formats (story_twist, mini_documentary) with cinematic or aiHook; off turns that off. Real people are never generated.",
+  "enum": [
+    "auto",
+    "off"
+  ],
+  "type": "string"
+}

Previous value: -5New value: +3

Previous value: -"Length of each stock B-roll clip in seconds (2–6, default 5). Not the full short length."New value: +"Length of each stock B-roll clip in seconds (2–6, default 3). Not the full short length."

Added value: +{
+  "description": "Alias of storyFormat. storyFormat wins when both are set.",
+  "enum": [
+    "mini_documentary",
+    "myth_check",
+    "story_twist",
+    "how_it_works",
+    "ranking",
+    "quiz",
+    "scary_story",
+    "history_pov",
+    "reddit_story",
+    "what_if"
+  ],
+  "type": "string"
+}

Added value: +{
+  "default": "pip_circle",
+  "description": "Where the host appears: pip_circle (default), pip_corner, or full frame. Only with hostNarratorId.",
+  "enum": [
+    "pip_circle",
+    "pip_corner",
+    "full"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Optional recurring host: a Character Films narrator (list_character_film_catalog) who appears lip-synced in the hook and outro. Quoted higher. Not available on the free short.",
+  "enum": [
+    "pip",
+    "mo",
+    "lulu",
+    "hazel",
+    "otto",
+    "rose",
+    "bo",
+    "sage",
+    "wren",
+    "kiko",
+    "tally",
+    "nib",
+    "chalk",
+    "rio",
+    "juno",
+    "yumi",
+    "kenji",
+    "dot",
+    "patch",
+    "ada",
+    "marlo",
+    "ollie",
+    "zara",
+    "barnaby",
+    "momo",
+    "bea",
+    "rex",
+    "nova",
+    "gus",
+    "tock",
+    "fern",
+    "duke",
+    "lumi",
+    "taro",
+    "oya",
+    "bolt",
+    "reginald",
+    "pepper",
+    "lola",
+    "moss",
+    "noor",
+    "arlo",
+    "mei",
+    "chip",
+    "bruno",
+    "stella",
+    "kai",
+    "plume",
+    "grumble",
+    "quill"
+  ],
+  "type": "string"
+}

Added value: +{
+  "default": "en",
+  "description": "Narration and caption language: en (English), es (Spanish), pt (Portuguese), de (German), fr (French), hi (Hindi). Default en. The planner writes the script in this language; pass a script already written in it. Stock search terms stay English.",
+  "enum": [
+    "en",
+    "es",
+    "pt",
+    "de",
+    "fr",
+    "hi"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Optional approved episode id from queue_topic_short_episodes. Uses that episode as the topic (when topic is empty) and the series style as the setup; explicit arguments still win. The short is linked to the episode. Quoted like any other short.",
+  "type": "string"
+}

Added value: +{
+  "description": "Pasted article text (200–20,000 characters) that grounds a sourced script.",
+  "maxLength": 20000,
+  "type": "string"
+}

Added value: +{
+  "description": "One https article or page link that grounds a sourced script. Same as a one-item sourceUrls.",
+  "type": "string"
+}

Added value: +{
+  "description": "Up to 3 https links that ground a sourced script. PDF uploads are website-only; paste the text with sourceText instead.",
+  "items": {
+    "description": "An https article or page link.",
+    "type": "string"
+  },
+  "maxItems": 3,
+  "type": "array"
+}

Added value: +{
+  "description": "Sourced script: research the topic, cite real sources, and soften or drop claims it cannot verify. The finished short carries a Sources card; get_topic_short returns the citations. Implied by sourceUrl, sourceUrls or sourceText. Not available on the free short.",
+  "type": "boolean"
+}

Previous value: -"Storytelling format: mini_documentary, myth_check, story_twist, or how_it_works. Defaults to mini_documentary."New value: +"Storytelling format: mini_documentary (Mini documentary), myth_check (Myth check), story_twist (Story with a twist), how_it_works (How it works), ranking (Top 5), quiz (Quiz), scary_story (Scary story), history_pov (History POV), reddit_story (Post story), what_if (What if). Defaults to mini_documentary. Each format has its own pacing, cards and music mood."

Previous value: -[
-  "mini_documentary",
-  "myth_check",
-  "story_twist",
-  "how_it_works"
-]New value: +[
+  "mini_documentary",
+  "myth_check",
+  "story_twist",
+  "how_it_works",
+  "ranking",
+  "quiz",
+  "scary_story",
+  "history_pov",
+  "reddit_story",
+  "what_if"
+]

Previous value: -"Spoken line for this beat. Combined beats fill the selected length at about 2.3 words per second."New value: +"Spoken line for this beat. Combined beats fill the selected length at about 2.6 words per second."

Previous value: -[
-  "mini_documentary",
-  "myth_check",
-  "story_twist",
-  "how_it_works"
-]New value: +[
+  "mini_documentary",
+  "myth_check",
+  "story_twist",
+  "how_it_works",
+  "ranking",
+  "quiz",
+  "scary_story",
+  "history_pov",
+  "reddit_story",
+  "what_if"
+]

Previous value: -"Topic to plan from. Optional when hookTemplateId seeds it. An explicit topic wins over the Opening hooks seed."New value: +"Topic to plan from. Required unless hookTemplateId seeds it or seriesEpisodeId supplies it. An explicit topic wins over either seed."

Added value: +{
+  "default": "standard",
+  "description": "Visual style: standard (judged stock footage, default) or cinematic (every shot is an AI keyframe animated to video). Cinematic is quoted higher and takes a few minutes longer. Not available on the free short. Real people and brands are never AI-generated.",
+  "enum": [
+    "standard",
+    "cinematic"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Optional id of one of your ready cloned voices (list_topic_short_voice_clones). Replaces voice. Paid plans only. Shorts narrated with a clone keep the AI-voice disclosure unless it was turned off when the voice was recorded.",
+  "type": "string"
+}

Removed value: -[
-  "topic"
-]

Added value: +{
+  "description": "Optional AI hook: the opening shot is an AI clip and abstract beats can get AI stills; the rest stays judged stock. Quoted higher. Any AI shot that misses its 2-minute deadline falls back to the best stock clip. Not available on the free short.",
+  "type": "boolean"
+}

Previous value: -"Frame size. 9:16 vertical (default) or 16:9 landscape."New value: +"Frame size. 9:16 vertical (default), 16:9 landscape, or 1:1 square for feeds."

Previous value: -[
-  "9:16",
-  "16:9"
-]New value: +[
+  "9:16",
+  "16:9",
+  "1:1"
+]

Previous value: -"Topic Short caption look: off, spotlight (default — each spoken word lights up on a blue highlight), impact (bold outlined caps, two words at a time), highlighter (caps with one yellow key word), editorial (quiet lower-third phrases), boxed (phrases on a rounded dark pill), or kicker (phrase chunks with one oversized cyan word up top). Same seven looks as Story; burned by the API from the voiceover word timings. English only. Does not change the quote amount. Caption failure still returns a finished short."New value: +"Topic Short caption look: off, spotlight (default — each spoken word lights up on a blue highlight), impact (bold outlined caps, two words at a time), highlighter (caps with one yellow key word), editorial (quiet lower-third phrases), boxed (phrases on a rounded dark pill), or kicker (phrase chunks with one oversized cyan word up top). Same seven looks as Story; burned by the API from the voiceover word timings, in the narration language (Hindi uses a Devanagari font). Does not change the quote amount. Caption failure still returns a finished short."

Added value: +{
+  "description": "auto (default) keeps one recurring fictional character consistent across shots on story formats (story_twist, mini_documentary) with cinematic or aiHook; off turns that off. Real people are never generated.",
+  "enum": [
+    "auto",
+    "off"
+  ],
+  "type": "string"
+}

Previous value: -5New value: +3

Previous value: -"Length of each stock B-roll clip in seconds (2–6, default 5). Not the full short length."New value: +"Length of each stock B-roll clip in seconds (2–6, default 3). Not the full short length."

Added value: +{
+  "description": "Alias of storyFormat. storyFormat wins when both are set.",
+  "enum": [
+    "mini_documentary",
+    "myth_check",
+    "story_twist",
+    "how_it_works",
+    "ranking",
+    "quiz",
+    "scary_story",
+    "history_pov",
+    "reddit_story",
+    "what_if"
+  ],
+  "type": "string"
+}

Added value: +{
+  "default": "pip_circle",
+  "description": "Where the host appears: pip_circle (default), pip_corner, or full frame. Only with hostNarratorId.",
+  "enum": [
+    "pip_circle",
+    "pip_corner",
+    "full"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Optional recurring host: a Character Films narrator (list_character_film_catalog) who appears lip-synced in the hook and outro. Quoted higher. Not available on the free short.",
+  "enum": [
+    "pip",
+    "mo",
+    "lulu",
+    "hazel",
+    "otto",
+    "rose",
+    "bo",
+    "sage",
+    "wren",
+    "kiko",
+    "tally",
+    "nib",
+    "chalk",
+    "rio",
+    "juno",
+    "yumi",
+    "kenji",
+    "dot",
+    "patch",
+    "ada",
+    "marlo",
+    "ollie",
+    "zara",
+    "barnaby",
+    "momo",
+    "bea",
+    "rex",
+    "nova",
+    "gus",
+    "tock",
+    "fern",
+    "duke",
+    "lumi",
+    "taro",
+    "oya",
+    "bolt",
+    "reginald",
+    "pepper",
+    "lola",
+    "moss",
+    "noor",
+    "arlo",
+    "mei",
+    "chip",
+    "bruno",
+    "stella",
+    "kai",
+    "plume",
+    "grumble",
+    "quill"
+  ],
+  "type": "string"
+}

Added value: +{
+  "default": "en",
+  "description": "Narration and caption language: en (English), es (Spanish), pt (Portuguese), de (German), fr (French), hi (Hindi). Default en. The planner writes the script in this language; pass a script already written in it. Stock search terms stay English.",
+  "enum": [
+    "en",
+    "es",
+    "pt",
+    "de",
+    "fr",
+    "hi"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Optional id of one of your earlier Topic Shorts (from generate_topic_short or get_topic_short). Copies its setup: voice, caption look, transitions, format, frame size, length and shot length. Any setting you pass explicitly wins. Never copies the topic, script or plan. Does not change how the short is priced. Pass the same value when quoting and generating.",
+  "type": "string"
+}

Added value: +{
+  "default": "part_two",
+  "description": "With recipeGenerationId: part_two makes Part 2 of that short; same_style reuses only its setup for a new topic. Pass the same value when quoting and generating.",
+  "enum": [
+    "part_two",
+    "same_style"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Optional approved episode id from queue_topic_short_episodes. Uses that episode as the topic (when topic is empty) and the series style as the setup; explicit arguments still win. The short is linked to the episode. Quoted like any other short.",
+  "type": "string"
+}

Added value: +{
+  "description": "Pasted article text (200–20,000 characters) that grounds a sourced script.",
+  "maxLength": 20000,
+  "type": "string"
+}

Added value: +{
+  "description": "One https article or page link that grounds a sourced script. Same as a one-item sourceUrls.",
+  "type": "string"
+}

Added value: +{
+  "description": "Up to 3 https links that ground a sourced script. PDF uploads are website-only; paste the text with sourceText instead.",
+  "items": {
+    "description": "An https article or page link.",
+    "type": "string"
+  },
+  "maxItems": 3,
+  "type": "array"
+}

Added value: +{
+  "description": "Sourced script: research the topic, cite real sources, and soften or drop claims it cannot verify. The finished short carries a Sources card; get_topic_short returns the citations. Implied by sourceUrl, sourceUrls or sourceText. Not available on the free short.",
+  "type": "boolean"
+}

Previous value: -"Storytelling format: mini_documentary, myth_check, story_twist, or how_it_works. Defaults to mini_documentary."New value: +"Storytelling format: mini_documentary (Mini documentary), myth_check (Myth check), story_twist (Story with a twist), how_it_works (How it works), ranking (Top 5), quiz (Quiz), scary_story (Scary story), history_pov (History POV), reddit_story (Post story), what_if (What if). Defaults to mini_documentary. Each format has its own pacing, cards and music mood."

Previous value: -[
-  "mini_documentary",
-  "myth_check",
-  "story_twist",
-  "how_it_works"
-]New value: +[
+  "mini_documentary",
+  "myth_check",
+  "story_twist",
+  "how_it_works",
+  "ranking",
+  "quiz",
+  "scary_story",
+  "history_pov",
+  "reddit_story",
+  "what_if"
+]

Previous value: -"Spoken line for this beat. Combined beats fill the selected length at about 2.3 words per second."New value: +"Spoken line for this beat. Combined beats fill the selected length at about 2.6 words per second."

Previous value: -[
-  "mini_documentary",
-  "myth_check",
-  "story_twist",
-  "how_it_works"
-]New value: +[
+  "mini_documentary",
+  "myth_check",
+  "story_twist",
+  "how_it_works",
+  "ranking",
+  "quiz",
+  "scary_story",
+  "history_pov",
+  "reddit_story",
+  "what_if"
+]

Previous value: -"Topic to plan from. Optional when hookTemplateId seeds it. An explicit topic wins over the Opening hooks seed."New value: +"Topic to plan from. Required unless hookTemplateId seeds it or seriesEpisodeId supplies it. An explicit topic wins over either seed."

Added value: +{
+  "default": "standard",
+  "description": "Visual style: standard (judged stock footage, default) or cinematic (every shot is an AI keyframe animated to video). Cinematic is quoted higher and takes a few minutes longer. Not available on the free short. Real people and brands are never AI-generated.",
+  "enum": [
+    "standard",
+    "cinematic"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Optional id of one of your ready cloned voices (list_topic_short_voice_clones). Replaces voice. Paid plans only. Shorts narrated with a clone keep the AI-voice disclosure unless it was turned off when the voice was recorded.",
+  "type": "string"
+}

Removed value: -[
-  "topic"
-]

Added value: +{
+  "description": "Cover still URL (opening frame), once export_topic_short format cover has made it.",
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": true,
+  "description": "When edits are on: whether captions and music can be edited, musicOptions (id, mood, previewUrl) for edit_topic_short, and freeEditsRemaining.",
+  "type": "object"
+}

Added value: +{
+  "description": "When the posting pack is on: each export format and whether export_topic_short can make it for this short.",
+  "items": {
+    "additionalProperties": true,
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "additionalProperties": true,
+  "description": "When the posting pack is on: suggested title, caption and hashtags for posting this short.",
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": true,
+  "description": "When edits are on: whether a public page exists and which version it is pinned to.",
+  "type": "object"
+}

Added value: +{
+  "additionalProperties": true,
+  "description": "The setup this short was made with: storyFormat, aspectRatio, language, visualStyle, renderTier, aiHook, characters, hostNarratorId, sourced, sourceInputs, voiceCloneId, seriesId and seriesEpisodeId (omitted fields are the defaults).",
+  "type": "object"
+}

Added value: +{
+  "description": "Completed short, when recorded: per-shot picks by beatIndex and shotIndex with judged alternates. An alternate id is the alternateId edit_topic_short kind swap_shot takes.",
+  "items": {
+    "additionalProperties": true,
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Sourced shorts only, once completed: the cited sources behind the narration (title, publisher, url, accessedAt), as shown on the clip page Sources card.",
+  "items": {
+    "additionalProperties": true,
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"Job status such as pending, queued, in_progress, completed, or failed."New value: +"Job status: submitting, queued, in_progress, composing (the voiceover and shots are done and the final edit is being put together), completed, or failed. Keep polling while it is composing."

Added value: +{
+  "description": "Completed short only, when edits are on: version 0 is the original, then one per edit_topic_short call (editId, version, kind, status, outputUrl, current, published).",
+  "items": {
+    "additionalProperties": true,
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Optional AI hook: the opening shot is an AI clip and abstract beats can get AI stills; the rest stays judged stock. Quoted higher. Any AI shot that misses its 2-minute deadline falls back to the best stock clip. Not available on the free short.",
+  "type": "boolean"
+}

Previous value: -"Frame size. 9:16 vertical (default) or 16:9 landscape."New value: +"Frame size. 9:16 vertical (default), 16:9 landscape, or 1:1 square for feeds."

Previous value: -[
-  "9:16",
-  "16:9"
-]New value: +[
+  "9:16",
+  "16:9",
+  "1:1"
+]

Previous value: -"Topic Short caption look: off, spotlight (default — each spoken word lights up on a blue highlight), impact (bold outlined caps, two words at a time), highlighter (caps with one yellow key word), editorial (quiet lower-third phrases), boxed (phrases on a rounded dark pill), or kicker (phrase chunks with one oversized cyan word up top). Same seven looks as Story; burned by the API from the voiceover word timings. English only. Does not change the quote amount. Caption failure still returns a finished short."New value: +"Topic Short caption look: off, spotlight (default — each spoken word lights up on a blue highlight), impact (bold outlined caps, two words at a time), highlighter (caps with one yellow key word), editorial (quiet lower-third phrases), boxed (phrases on a rounded dark pill), or kicker (phrase chunks with one oversized cyan word up top). Same seven looks as Story; burned by the API from the voiceover word timings, in the narration language (Hindi uses a Devanagari font). Does not change the quote amount. Caption failure still returns a finished short."

Added value: +{
+  "description": "auto (default) keeps one recurring fictional character consistent across shots on story formats (story_twist, mini_documentary) with cinematic or aiHook; off turns that off. Real people are never generated.",
+  "enum": [
+    "auto",
+    "off"
+  ],
+  "type": "string"
+}

Previous value: -5New value: +3

Previous value: -"Length of each stock B-roll clip in seconds (2–6, default 5). Not the full short length."New value: +"Length of each stock B-roll clip in seconds (2–6, default 3). Not the full short length."

Added value: +{
+  "description": "Alias of storyFormat. storyFormat wins when both are set.",
+  "enum": [
+    "mini_documentary",
+    "myth_check",
+    "story_twist",
+    "how_it_works",
+    "ranking",
+    "quiz",
+    "scary_story",
+    "history_pov",
+    "reddit_story",
+    "what_if"
+  ],
+  "type": "string"
+}

Added value: +{
+  "default": "pip_circle",
+  "description": "Where the host appears: pip_circle (default), pip_corner, or full frame. Only with hostNarratorId.",
+  "enum": [
+    "pip_circle",
+    "pip_corner",
+    "full"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Optional recurring host: a Character Films narrator (list_character_film_catalog) who appears lip-synced in the hook and outro. Quoted higher. Not available on the free short.",
+  "enum": [
+    "pip",
+    "mo",
+    "lulu",
+    "hazel",
+    "otto",
+    "rose",
+    "bo",
+    "sage",
+    "wren",
+    "kiko",
+    "tally",
+    "nib",
+    "chalk",
+    "rio",
+    "juno",
+    "yumi",
+    "kenji",
+    "dot",
+    "patch",
+    "ada",
+    "marlo",
+    "ollie",
+    "zara",
+    "barnaby",
+    "momo",
+    "bea",
+    "rex",
+    "nova",
+    "gus",
+    "tock",
+    "fern",
+    "duke",
+    "lumi",
+    "taro",
+    "oya",
+    "bolt",
+    "reginald",
+    "pepper",
+    "lola",
+    "moss",
+    "noor",
+    "arlo",
+    "mei",
+    "chip",
+    "bruno",
+    "stella",
+    "kai",
+    "plume",
+    "grumble",
+    "quill"
+  ],
+  "type": "string"
+}

Added value: +{
+  "default": "en",
+  "description": "Narration and caption language: en (English), es (Spanish), pt (Portuguese), de (German), fr (French), hi (Hindi). Default en. The planner writes the script in this language; pass a script already written in it. Stock search terms stay English.",
+  "enum": [
+    "en",
+    "es",
+    "pt",
+    "de",
+    "fr",
+    "hi"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Optional id of one of your earlier Topic Shorts (from generate_topic_short or get_topic_short). Copies its setup: voice, caption look, transitions, format, frame size, length and shot length. Any setting you pass explicitly wins. Never copies the topic, script or plan. Does not change how the short is priced. Pass the same value when quoting and generating.",
+  "type": "string"
+}

Added value: +{
+  "default": "part_two",
+  "description": "With recipeGenerationId: part_two makes Part 2 of that short; same_style reuses only its setup for a new topic. Pass the same value when quoting and generating.",
+  "enum": [
+    "part_two",
+    "same_style"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Optional approved episode id from queue_topic_short_episodes. Uses that episode as the topic (when topic is empty) and the series style as the setup; explicit arguments still win. The short is linked to the episode. Quoted like any other short.",
+  "type": "string"
+}

Added value: +{
+  "description": "Pasted article text (200–20,000 characters) that grounds a sourced script.",
+  "maxLength": 20000,
+  "type": "string"
+}

Added value: +{
+  "description": "One https article or page link that grounds a sourced script. Same as a one-item sourceUrls.",
+  "type": "string"
+}

Added value: +{
+  "description": "Up to 3 https links that ground a sourced script. PDF uploads are website-only; paste the text with sourceText instead.",
+  "items": {
+    "description": "An https article or page link.",
+    "type": "string"
+  },
+  "maxItems": 3,
+  "type": "array"
+}

Added value: +{
+  "description": "Sourced script: research the topic, cite real sources, and soften or drop claims it cannot verify. The finished short carries a Sources card; get_topic_short returns the citations. Implied by sourceUrl, sourceUrls or sourceText. Not available on the free short.",
+  "type": "boolean"
+}

Previous value: -"Storytelling format: mini_documentary, myth_check, story_twist, or how_it_works. Defaults to mini_documentary."New value: +"Storytelling format: mini_documentary (Mini documentary), myth_check (Myth check), story_twist (Story with a twist), how_it_works (How it works), ranking (Top 5), quiz (Quiz), scary_story (Scary story), history_pov (History POV), reddit_story (Post story), what_if (What if). Defaults to mini_documentary. Each format has its own pacing, cards and music mood."

Previous value: -[
-  "mini_documentary",
-  "myth_check",
-  "story_twist",
-  "how_it_works"
-]New value: +[
+  "mini_documentary",
+  "myth_check",
+  "story_twist",
+  "how_it_works",
+  "ranking",
+  "quiz",
+  "scary_story",
+  "history_pov",
+  "reddit_story",
+  "what_if"
+]

Previous value: -"Spoken line for this beat. Combined beats fill the selected length at about 2.3 words per second."New value: +"Spoken line for this beat. Combined beats fill the selected length at about 2.6 words per second."

Previous value: -[
-  "mini_documentary",
-  "myth_check",
-  "story_twist",
-  "how_it_works"
-]New value: +[
+  "mini_documentary",
+  "myth_check",
+  "story_twist",
+  "how_it_works",
+  "ranking",
+  "quiz",
+  "scary_story",
+  "history_pov",
+  "reddit_story",
+  "what_if"
+]

Previous value: -"Topic to plan from. Optional when hookTemplateId seeds it. An explicit topic wins over the Opening hooks seed."New value: +"Topic to plan from. Required unless hookTemplateId seeds it or seriesEpisodeId supplies it. An explicit topic wins over either seed."

Added value: +{
+  "default": "standard",
+  "description": "Visual style: standard (judged stock footage, default) or cinematic (every shot is an AI keyframe animated to video). Cinematic is quoted higher and takes a few minutes longer. Not available on the free short. Real people and brands are never AI-generated.",
+  "enum": [
+    "standard",
+    "cinematic"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Optional id of one of your ready cloned voices (list_topic_short_voice_clones). Replaces voice. Paid plans only. Shorts narrated with a clone keep the AI-voice disclosure unless it was turned off when the voice was recorded.",
+  "type": "string"
+}

Removed value: -[
-  "topic"
-]

Previous value: -"Image Lab model slug from list_image_lab_models (gpt-image-2-5, nano-banana, nano-banana-2, nano-banana-pro, flux-2-pro, mai-image-2-5, mai-image-2-5-pro, seedream-5-lite, muse-image, grok-imagine-image-2, qwen-image-3, kling-image-o3)."New value: +"Image Lab model slug from list_image_lab_models (gpt-image-2-5, nano-banana, nano-banana-2, nano-banana-pro, flux-2-pro, mai-image-2-5, mai-image-2-5-pro, seedream-5-lite, muse-image, grok-imagine-image-2, qwen-image-3, kling-image-o3, flux-3-image, ideogram-v4-5, seedream-5-flash, recraft-v4-1-flash)."

Previous value: -"How this render was billed: the monthly plan, or the complimentary film opening."New value: +"How this render was billed: the monthly plan (older renders may show the retired complimentary film opening)."

Previous value: -"True when this opening is the free first film opening for this account."New value: +"Always false for new quotes. The free film opening is retired."

Previous value: -"Narration script. Required unless quoteId is set. Must match the quote when quoteId is set."New value: +"Narration script. Omit when quoteId is set. 5,000 characters or fewer when quoting from generate."

Added value: +5000

Previous value: -"Voice id from list_audio_lab_voices. Must match the quote when quoteId is set."New value: +"Clip Studio voice name from list_audio_lab_voices (for example Russ). Not the ElevenLabs voice_id. Omit when quoteId is set."

Removed value: -[
-  "script"
-]

Previous value: -"Still aspect from the catalog. Must match the quote when quoteId is set."New value: +"Still aspect from list_image_lab_models for that slug. Omit when quoteId is set."

Added value: +{
+  "description": "Same as mode: text_to_image or image_to_image.",
+  "type": "string"
+}

Previous value: -"text_to_image or image_to_image. Must match the quote when quoteId is set."New value: +"text_to_image or image_to_image. Must match the quote when quoteId is set. Same as inputMode."

Previous value: -"What to draw. Must match the quoted setup when quoteId is set."New value: +"What to draw. Omit when quoteId is set."

Previous value: -"Same source still asset ids used on the quote."New value: +"Same source still asset ids used on the quote. Omit when quoteId is set."

Added value: +{
+  "description": "Source still generation-asset id for image_to_image. Omit when quoteId is set.",
+  "type": "string"
+}

Removed value: -[
-  "prompt"
-]

Previous value: -"Frame size from the model catalog. Must match the quote when quoteId is set."New value: +"Frame size from the model catalog. Omit when quoteId is set."

Previous value: -"Native audio flag for models that list audio as optional. Must match the quote when quoteId is set."New value: +"Native audio flag for models that list audio as optional. Omit when quoteId is set."

Previous value: -"Clip length in seconds. Must match the quote when quoteId is set."New value: +"Clip length in seconds. Omit when quoteId is set; generate uses the quoted setup."

Added value: +{
+  "description": "End-frame generation-asset id. Same as sourceAssetIds[1] for first_last_frame.",
+  "type": "string"
+}

Added value: +{
+  "description": "Frames per second when the catalog lists that control.",
+  "type": "number"
+}

Added value: +{
+  "description": "Same as mode: text_to_video, image_to_video, first_last_frame, reference_to_video, or edit_video.",
+  "type": "string"
+}

Added value: +{
+  "description": "Kling 3 Pro / Kling 3 4K subject packs. Each element needs a frontal still and supporting references. The first primary still is the start frame when startImageAssetId is omitted. Do not send leftover stills as sourceAssetIds references on those models.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "primaryImageAssetId": {
+        "description": "Frontal still generation-asset id from complete_generation_asset.",
+        "type": "string"
+      },
+      "referenceImageAssetIds": {
+        "description": "Supporting stills for this Kling subject.",
+        "items": {
+          "description": "Supporting still generation-asset id.",
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "primaryImageAssetId"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Multi-shot / intelligent shot type when the catalog lists that control.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Negative prompt when list_video_lab_models lists that control for the mode.",
+  "type": "string"
+}

Previous value: -"What to film. Up to 8,192 UTF-8 bytes. Must match the quoted setup when quoteId is set."New value: +"What to film. Omit when quoteId is set. Up to 8,192 UTF-8 bytes when quoting from generate."

Added value: +{
+  "description": "Prompt expansion when the catalog lists that control. false maps to fal disabled on MiniMax H3 and H3 Max.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Reference stills for reference_to_video. Do not send leftover stills here on Kling 3 Pro / Kling 3 4K when klingElements is set.",
+  "items": {
+    "description": "Reference still generation-asset id.",
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -"Output resolution from the model catalog. Must match the quote when quoteId is set."New value: +"Output resolution from the model catalog. Omit when quoteId is set."

Added value: +{
+  "description": "Seed when the catalog lists that control.",
+  "type": "number"
+}

Added value: +{
+  "description": "Source MP4 generation-asset id for edit_video. Same as sourceAssetIds[0] for that mode.",
+  "type": "string"
+}

Added value: +{
+  "description": "Start-frame generation-asset id. Same as sourceAssetIds[0] for image_to_video and first_last_frame.",
+  "type": "string"
+}

Added value: +{
+  "description": "Style id when the catalog lists that control. Omit or none for the default look.",
+  "type": "string"
+}

Removed value: -[
-  "prompt"
-]

Previous value: -"Default voice id."New value: +"Default Clip Studio voice name (not an ElevenLabs voice_id)."

Previous value: -"Narration voices with id, name, accent, locale, and preview URL."New value: +"Narration voices. id and name are the Clip Studio voice name, plus accent, locale, and preview URL."

Previous value: -"Narration script to quote. Character count drives the quote."New value: +"Narration script to quote. 5,000 characters or fewer. Character count drives the quote."

Added value: +5000

Added value: +1

Previous value: -"Voice id from list_audio_lab_voices. Defaults to the product default voice."New value: +"Clip Studio voice name from list_audio_lab_voices (for example Russ). Not the ElevenLabs voice_id. Defaults to the product default voice."

Previous value: -"Voice id this quote locked in."New value: +"Clip Studio voice name this quote locked in."

Previous value: -"Still aspect from the catalog: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, or 9:16."New value: +"Still aspect from list_image_lab_models for that slug (for example 16:9 or 9:16). Not every model lists every ratio."

Added value: +{
+  "description": "Same as mode: text_to_image or image_to_image.",
+  "type": "string"
+}

Previous value: -"text_to_image or image_to_image. image_to_image needs sourceAssetIds."New value: +"text_to_image or image_to_image. image_to_image needs sourceAssetIds. Same as inputMode."

Previous value: -"Image Lab model slug from list_image_lab_models (gpt-image-2-5, nano-banana, nano-banana-2, nano-banana-pro, flux-2-pro, mai-image-2-5, mai-image-2-5-pro, seedream-5-lite, muse-image, grok-imagine-image-2, qwen-image-3, kling-omni-3)."New value: +"Image Lab model slug from list_image_lab_models (gpt-image-2-5, nano-banana, nano-banana-2, nano-banana-pro, flux-2-pro, mai-image-2-5, mai-image-2-5-pro, seedream-5-lite, muse-image, grok-imagine-image-2, qwen-image-3, kling-image-o3)."

Added value: +{
+  "description": "Source still generation-asset id for image_to_image. Same as sourceAssetIds[0].",
+  "type": "string"
+}

Added value: +{
+  "description": "End-frame generation-asset id. Same as sourceAssetIds[1] for first_last_frame.",
+  "type": "string"
+}

Added value: +{
+  "description": "Frames per second when the catalog lists that control.",
+  "type": "number"
+}

Added value: +{
+  "description": "Same as mode: text_to_video, image_to_video, first_last_frame, reference_to_video, or edit_video.",
+  "type": "string"
+}

Added value: +{
+  "description": "Kling 3 Pro / Kling 3 4K subject packs. Each element needs a frontal still and supporting references. The first primary still is the start frame when startImageAssetId is omitted. Do not send leftover stills as sourceAssetIds references on those models.",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "primaryImageAssetId": {
+        "description": "Frontal still generation-asset id from complete_generation_asset.",
+        "type": "string"
+      },
+      "referenceImageAssetIds": {
+        "description": "Supporting stills for this Kling subject.",
+        "items": {
+          "description": "Supporting still generation-asset id.",
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "primaryImageAssetId"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"Video Lab model slug from list_video_lab_models (for example seedance-2-0, minimax-h3, grok-imagine-1-5)."New value: +"Video Lab model slug from list_video_lab_models (for example seedance-2-5, minimax-h3, grok-imagine-video-1-5)."

Added value: +{
+  "description": "Multi-shot / intelligent shot type when the catalog lists that control.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Negative prompt when list_video_lab_models lists that control for the mode.",
+  "type": "string"
+}

Previous value: -"What to film. Up to 8,192 UTF-8 bytes. For edit_video, describe the change to the source clip."New value: +"What to film. At least 3 characters, up to 8,192 UTF-8 bytes. For edit_video, describe the change to the source clip."

Added value: +3

Added value: +{
+  "description": "Prompt expansion when the catalog lists that control. false maps to fal disabled on MiniMax H3 and H3 Max.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Reference stills for reference_to_video. Do not send leftover stills here on Kling 3 Pro / Kling 3 4K when klingElements is set.",
+  "items": {
+    "description": "Reference still generation-asset id.",
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Seed when the catalog lists that control.",
+  "type": "number"
+}

Added value: +{
+  "description": "Source MP4 generation-asset id for edit_video. Same as sourceAssetIds[0] for that mode.",
+  "type": "string"
+}

Added value: +{
+  "description": "Start-frame generation-asset id. Same as sourceAssetIds[0] for image_to_video and first_last_frame.",
+  "type": "string"
+}

Added value: +{
+  "description": "Style id when the catalog lists that control. Omit or none for the default look.",
+  "type": "string"
+}

Previous value: -"Illustration looks (id, name, tagline). Pick lookId from this list."New value: +"Illustration looks (id, name, tagline) for reference. Each narrator has a fixed lookId; there is no separate look choice."

Previous value: -"Narrators (id, name, tagline, archetype). Pick narratorId from this list."New value: +"Narrators (id, name, tagline, archetype, voiceName, lookId). Pick narratorId from this list; the narrator brings its own look and voice."

Previous value: -"Illustration look id from list_character_film_catalog (the style of every frame)."New value: +"Ignored. The narrator’s fixed look is used. Kept so older agents that still send lookId do not hard-fail."

Removed value: -[
-  "claymation",
-  "watercolor-anime",
-  "ligne-claire",
-  "crayon",
-  "marker-sketch",
-  "gouache-storybook",
-  "paper-cutout",
-  "pixel"
-]

Previous value: -"Narrator id from list_character_film_catalog. The narrator’s voice is used; there is no separate voice choice."New value: +"Narrator id from list_character_film_catalog. The narrator is the whole character: its look and voice are used; there is no separate look or voice choice."

Previous value: -[
-  "nib",
-  "kiko",
-  "stella",
-  "rex",
-  "rio",
-  "wren",
-  "juno",
-  "mina"
-]New value: +[
+  "pip",
+  "mo",
+  "lulu",
+  "hazel",
+  "otto",
+  "rose",
+  "bo",
+  "sage",
+  "wren",
+  "kiko",
+  "tally",
+  "nib",
+  "chalk",
+  "rio",
+  "juno",
+  "yumi",
+  "kenji",
+  "dot",
+  "patch",
+  "ada",
+  "marlo",
+  "ollie",
+  "zara",
+  "barnaby",
+  "momo",
+  "bea",
+  "rex",
+  "nova",
+  "gus",
+  "tock",
+  "fern",
+  "duke",
+  "lumi",
+  "taro",
+  "oya",
+  "bolt",
+  "reginald",
+  "pepper",
+  "lola",
+  "moss",
+  "noor",
+  "arlo",
+  "mei",
+  "chip",
+  "bruno",
+  "stella",
+  "kai",
+  "plume",
+  "grumble",
+  "quill"
+]

Previous value: -[
-  "topic",
-  "narratorId",
-  "lookId",
-  "lengthSeconds"
-]New value: +[
+  "topic",
+  "narratorId",
+  "lengthSeconds"
+]

Previous value: -"Narrator id from list_character_film_catalog (who tells the story)."New value: +"Narrator id from list_character_film_catalog. The narrator’s voice is used; there is no separate voice choice."

Previous value: -"Narration voice id from list_audio_lab_voices. Same catalog as Audio Lab / Story."New value: +"Ignored. The narrator’s fixed voice is used. Kept so older agents that still send voiceId do not hard-fail."

Previous value: -[
-  "topic",
-  "narratorId",
-  "lookId",
-  "voiceId",
-  "lengthSeconds"
-]New value: +[
+  "topic",
+  "narratorId",
+  "lookId",
+  "lengthSeconds"
+]

Added value: +{
+  "description": "Sanitized provider detail (endpoint, HTTP status, first 300 characters). Never a prompt.",
+  "type": "string"
+}

Added value: +{
+  "description": "Pipeline stage that failed, when known.",
+  "type": "string"
+}

Removed value: -{
-  "description": "Story caption looks Character Films can burn in.",
-  "items": {
-    "description": "Caption look id such as spotlight or off.",
-    "type": "string"
-  },
-  "type": "array"
-}

Removed value: -{
-  "description": "Default caption look (spotlight).",
-  "type": "string"
-}

Removed value: -{
-  "default": "spotlight",
-  "description": "Burned-in caption look from the Story catalog: off, spotlight (default), impact, highlighter, editorial, boxed, or kicker. Shared with Story and Topic Shorts. Does not change the quote. Caption failure still ships the film.",
-  "enum": [
-    "off",
-    "spotlight",
-    "impact",
-    "highlighter",
-    "editorial",
-    "boxed",
-    "kicker"
-  ],
-  "type": "string"
-}

Removed value: -{
-  "description": "Burned-in caption look from the Story catalog.",
-  "type": "string"
-}

Previous value: -"Full film length in seconds (30, 60, 120, or 180). The opening (block 1, at most 15 seconds) renders first; continue_character_film films the rest."New value: +"Full film length in seconds (30, 60, 120, or 180). The opening (block 1, at most 8 seconds) renders first; continue_character_film films the rest."

Previous value: -"Ordered script blocks. Block 1 is the opening (at most 15 seconds)."New value: +"Ordered script blocks. Block 1 is the opening (at most 8 seconds)."

Previous value: -"Duration of block 1, at most 15 seconds."New value: +"Duration of block 1, at most 8 seconds."

Previous value: -"opening is the first block (at most 15 seconds). remaining is every later block. Continue this film uses remaining after the opening is completed."New value: +"opening is the first block (at most 8 seconds). remaining is every later block. Continue this film uses remaining after the opening is completed."

Previous value: -"Optional product kind filter (topic_short, video_lab, story, talking_short, ad_studio, and other public kinds)."New value: +"Optional product kind filter (topic_short, video_lab, story, talking_short, ad_studio, character_film, and other public kinds)."

Previous value: -"English Pexels queries for this beat. Keep the topic’s concrete nouns (people, places, sports, objects). Relatable faces, hands, and motion when they belong to that topic — not generic stock abstraction. English only. Put the strongest on-topic visual first (hook beat plays in the first 1.2s). Later terms should be broader on-topic fallbacks (soccer / football / stadium, not cooking or cafe). Generate fail-opens with topic-near sports footage before lifestyle catalog if Pexels misses, and still ships last-resort clips if Pexels is down. Distinct clips per shot and per beat; identical reuse is last resort."New value: +"English Pexels queries for this beat. Name what this narration is saying (people, places, objects, actions), then the topic. Relatable faces, hands, and motion only when they belong to that spoken line — not a reused talking-head or walking-street clip. English only. Put the strongest visual for this line first (hook beat plays in the first 1.2s). Later terms should be broader on-topic fallbacks (soccer / football / stadium, not cooking or cafe). Generate searches this beat’s narration first, then topic-near sports footage, then lifestyle catalog if Pexels misses, and still ships last-resort clips if Pexels is down. Distinct clips per shot and per beat; identical reuse is last resort."

Previous value: -"One English Pexels query for this beat (people, places, sports, or objects named in the topic)."New value: +"One English Pexels query for this beat (people, places, objects, or actions named in this spoken line)."

Previous value: -"English Pexels queries for this beat. Keep the topic’s concrete nouns (people, places, sports, objects). Relatable faces, hands, and motion when they belong to that topic — not generic stock abstraction. English only. Put the strongest on-topic visual first (hook beat plays in the first 1.2s). Later terms should be broader on-topic fallbacks (soccer / football / stadium, not cooking or cafe). Generate fail-opens with topic-near sports footage before lifestyle catalog if Pexels misses, and still ships last-resort clips if Pexels is down. Distinct clips per shot and per beat; identical reuse is last resort."New value: +"English Pexels queries for this beat. Name what this narration is saying (people, places, objects, actions), then the topic. Relatable faces, hands, and motion only when they belong to that spoken line — not a reused talking-head or walking-street clip. English only. Put the strongest visual for this line first (hook beat plays in the first 1.2s). Later terms should be broader on-topic fallbacks (soccer / football / stadium, not cooking or cafe). Generate searches this beat’s narration first, then topic-near sports footage, then lifestyle catalog if Pexels misses, and still ships last-resort clips if Pexels is down. Distinct clips per shot and per beat; identical reuse is last resort."

Previous value: -"One English Pexels query for this beat (people, places, sports, or objects named in the topic)."New value: +"One English Pexels query for this beat (people, places, objects, or actions named in this spoken line)."

Previous value: -"English Pexels queries for this beat. Keep the topic’s concrete nouns (people, places, sports, objects). Relatable faces, hands, and motion when they belong to that topic — not generic stock abstraction. English only. Put the strongest on-topic visual first (hook beat plays in the first 1.2s). Later terms should be broader on-topic fallbacks (soccer / football / stadium, not cooking or cafe). Generate fail-opens with topic-near sports footage before lifestyle catalog if Pexels misses, and still ships last-resort clips if Pexels is down. Distinct clips per shot and per beat; identical reuse is last resort."New value: +"English Pexels queries for this beat. Name what this narration is saying (people, places, objects, actions), then the topic. Relatable faces, hands, and motion only when they belong to that spoken line — not a reused talking-head or walking-street clip. English only. Put the strongest visual for this line first (hook beat plays in the first 1.2s). Later terms should be broader on-topic fallbacks (soccer / football / stadium, not cooking or cafe). Generate searches this beat’s narration first, then topic-near sports footage, then lifestyle catalog if Pexels misses, and still ships last-resort clips if Pexels is down. Distinct clips per shot and per beat; identical reuse is last resort."

Previous value: -"One English Pexels query for this beat (people, places, sports, or objects named in the topic)."New value: +"One English Pexels query for this beat (people, places, objects, or actions named in this spoken line)."