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"
-]

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)."