<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Kling4 AI</title>
    <description>The latest articles on DEV Community by Kling4 AI (@kling4ai-production).</description>
    <link>https://dev.to/kling4ai-production</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F3982883%2F5f44d4d8-585c-4ac2-844f-c79ac302ab3e.png</url>
      <title>DEV Community: Kling4 AI</title>
      <link>https://dev.to/kling4ai-production</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/kling4ai-production"/>
    <language>en</language>
    <item>
      <title>Best AI Santa Video Generators for 2026: Create Personalized Holiday Greetings in Minutes</title>
      <dc:creator>Kling4 AI</dc:creator>
      <pubDate>Mon, 16 Nov 2026 06:56:11 +0000</pubDate>
      <link>https://dev.to/kling4ai-production/best-ai-santa-video-generators-for-2026-create-personalized-holiday-greetings-in-minutes-3o92</link>
      <guid>https://dev.to/kling4ai-production/best-ai-santa-video-generators-for-2026-create-personalized-holiday-greetings-in-minutes-3o92</guid>
      <description>&lt;p&gt;As the holiday season approaches, family creators, educators, and boutique marketers are turning away from static e-cards toward cinematic, personalized seasonal media. Recent breakthroughs in diffusion transformer pipelines have enabled automated video rendering that maintains character consistency, natural facial cadence, and seasonal ambiance in a single seamless generation pass.&lt;/p&gt;

&lt;p&gt;According to technical benchmarks released across &lt;a href="https://seed.bytedance.com/en/seedream5_0_pro" rel="noopener noreferrer"&gt;ByteDance Seedream Research&lt;/a&gt;, multi-frame character identity preservation under changing festive lighting requires strict spatial conditioning and motion compensation. Modern generative engines eliminate the uncanny flicker typical of legacy generative systems, allowing lifelike depictions of Santa delivering bespoke greetings, storytelling segments, and classroom messages.&lt;/p&gt;

&lt;p&gt;For users seeking an accessible, browser-first solution without complicated local installations or costly subscription walls, the &lt;a href="https://freesanta.co/" rel="noopener noreferrer"&gt;AI Santa Video Generator&lt;/a&gt; on FreeSanta delivers high-definition seasonal greeting videos directly from intuitive text descriptions and portrait inputs. New creators can experiment with expressive narrative templates, customized holiday scenery, and multi-language voice outputs to craft memorable holiday keepsakes.&lt;/p&gt;

</description>
      <category>ai</category>
      <category>video</category>
      <category>machinelearning</category>
    </item>
    <item>
      <title>A Personalized Santa Video Says Their Name in a Greeting You Can Keep</title>
      <dc:creator>Kling4 AI</dc:creator>
      <pubDate>Sun, 15 Nov 2026 05:09:53 +0000</pubDate>
      <link>https://dev.to/kling4ai-production/a-personalized-santa-video-says-their-name-in-a-greeting-you-can-keep-4o42</link>
      <guid>https://dev.to/kling4ai-production/a-personalized-santa-video-says-their-name-in-a-greeting-you-can-keep-4o42</guid>
      <description>&lt;p&gt;A personalized Santa video is a short Christmas greeting you generate with a name or a custom line, then review, keep and send. On FreeSanta, a spoken name is a speech job that needs the selected model's actual audio controls, and a 5- or 10-second visit on Seedance 2.0 is the window for that line.&lt;/p&gt;

&lt;h2&gt;
  
  
  Key Takeaways
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;The greeting is a file you can replay.&lt;/strong&gt; You generate it, you watch it all the way through, and you decide whether to send it. FreeSanta's own guide on a Santa video call versus a video message is about that kind of greeting: interaction, scripting, personalization and review.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A spoken name is a speech job.&lt;/strong&gt; Check the model's actual audio and speech controls. Listen to the whole clip, especially for names, before you share it. A visual brief alone cannot guarantee pronunciation.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A personalized message and a Santa Cam scene are different tasks.&lt;/strong&gt; The camera-style scene is about Santa appearing in a place. The greeting is about a message you can keep. They can share a workspace without being the same brief.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The &lt;a href="https://freesanta.co/" rel="noopener noreferrer"&gt;AI Santa Video Generator&lt;/a&gt; at FreeSanta is the place that greeting is made,&lt;/strong&gt; on Seedance 2.0 for a short living-room visit, listed at 5 or 10 seconds, with Christmas stills on the same floor.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Live two-way Santa calls are a neighboring product category.&lt;/strong&gt; Long-running message services offer scheduled calls and live conversations. FreeSanta's greeting is the clip you review and then keep.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  What You Are Holding When the Clip Is Done
&lt;/h2&gt;

&lt;p&gt;The word "personalized" does a lot of work in a December search. It can mean a form you fill in with a child's name, so that a prebuilt Santa story says that name. It can mean a live or scheduled call, where someone — or a live system — is on the other end of the line. And it can mean a generated greeting: a short video you asked a model to make, with a scene, a room, maybe a spoken line, that you then watch all the way through and send.&lt;/p&gt;

&lt;p&gt;FreeSanta is the third of those. The Personalized Santa Video page and the Santa Video Call vs Video Message guide both exist to keep that greeting clearly described. The FAQ is the shortest version. A spoken message requires a model with suitable audio and speech support. Check its actual controls. Listen to the full result before sharing, especially for names. The clip is a file. You can replay it. You can decide not to send it.&lt;/p&gt;

&lt;p&gt;That last part is the product. A greeting you can keep is one you have already heard.&lt;/p&gt;

&lt;h2&gt;
  
  
  A Spoken Line Has to Be a Real Control
&lt;/h2&gt;

&lt;p&gt;The tempting mistake is to treat a name as a detail in the picture brief: if Santa is in the room, and the brief mentions a name, the name will be heard. FreeSanta says the opposite. A visual prompt alone cannot guarantee pronunciation. A spoken greeting needs audio and speech controls that the selected model actually offers.&lt;/p&gt;

&lt;p&gt;That is a workflow fit, and it is a spec boundary. Official Seedance 2.0, the ByteDance model FreeSanta uses for a Santa visit, is an audio-video model: the 12 February 2026 launch describes synchronized, dual-channel audio on a 4-to-15-second take. That is the official family capability. A given workspace still has to show those controls, and a particular name still has to come out the way you spelled it. FreeSanta's rule is to look at the controls that are actually in front of you, and to listen to the result.&lt;/p&gt;

&lt;p&gt;The duration of the visit on this site is a 5- or 10-second run. That is long enough for a short greeting, and short enough that the line has to be a small one. A two-way conversation at a set time lives in a different product category. Long-running Santa message services — Portable North Pole is the established one, with calls and a live Talk to Santa path since well before this generative wave — are built for that category. FreeSanta's greeting is the short clip you generate and then keep.&lt;/p&gt;

&lt;h2&gt;
  
  
  Two Christmas Jobs, One Workspace, Still Two Jobs
&lt;/h2&gt;

&lt;p&gt;FreeSanta also separates the personalized greeting from the Santa Cam scene. The camera-style visit is about Santa appearing in a place, usually from a photograph of a room, as a creative holiday scene. The greeting is about a message. They share Seedance 2.0, and they share the same 5- or 10-second window, and they are still different briefs. A clip that has to say a name has a speech check. A clip that has to look like a living-room camera has a room-and-action brief. Doing both at once does not turn either check off.&lt;/p&gt;

&lt;p&gt;Review is the last official step, and it is the one that makes a greeting you can keep. Watch the whole sequence, not just a cover image. Listen to the whole line, not just the first word. If a name is off, that is a result to reject and run again. The file is yours to keep only after the name has landed.&lt;/p&gt;

&lt;p&gt;A personalized Santa video, in this workspace, is a short greeting you can hold: generated with a spoken line when the controls are there, reviewed all the way through, and sent when the name is right.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F6xcq6bh4ilt5b3n21ea9.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F6xcq6bh4ilt5b3n21ea9.jpg" alt="FreeSanta's Santa Video Call vs Video Message guide, on a generated Christmas greeting you can review and keep" width="800" height="500"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Source: &lt;a href="https://freesanta.co/guides/santa-video-call-vs-message/" rel="noopener noreferrer"&gt;Santa Video Call vs Video Message&lt;/a&gt;, FreeSanta's guide to a Santa video call and a video message — interaction, scripting, personalization and review.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
    </item>
    <item>
      <title>How do you handle context degradation when chaining multiple tools in an AI Agent?</title>
      <dc:creator>Kling4 AI</dc:creator>
      <pubDate>Sat, 14 Nov 2026 06:05:47 +0000</pubDate>
      <link>https://dev.to/kling4ai-production/how-do-you-handle-context-degradation-when-chaining-multiple-tools-in-an-ai-agent-4o38</link>
      <guid>https://dev.to/kling4ai-production/how-do-you-handle-context-degradation-when-chaining-multiple-tools-in-an-ai-agent-4o38</guid>
      <description>&lt;p&gt;As tool ecosystems grow and agents call multiple external tools in sequence, prompt bloat and verbose tool returns start degrading context rapidly.&lt;/p&gt;

&lt;p&gt;In your workflows, do you prefer:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Truncating or summarizing previous tool outputs before sending the next turn?&lt;/li&gt;
&lt;li&gt;Spawning isolated subagents and passing only synthesized state back to the coordinator?&lt;/li&gt;
&lt;li&gt;Enforcing strict, minimal schemas to keep payload footprints small?&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Would love to hear what patterns have proven most reliable in your production setups!&lt;/p&gt;

</description>
      <category>agents</category>
      <category>ai</category>
      <category>architecture</category>
      <category>llm</category>
    </item>
    <item>
      <title>Nano Banana 3.0 Writes the Headline and Keeps the Face Across Scenes</title>
      <dc:creator>Kling4 AI</dc:creator>
      <pubDate>Fri, 13 Nov 2026 19:01:48 +0000</pubDate>
      <link>https://dev.to/kling4ai-production/nano-banana-30-writes-the-headline-and-keeps-the-face-across-scenes-plc</link>
      <guid>https://dev.to/kling4ai-production/nano-banana-30-writes-the-headline-and-keeps-the-face-across-scenes-plc</guid>
      <description>&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fxdmc8iywzftt8b3n8xfw.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fxdmc8iywzftt8b3n8xfw.jpg" alt="Cover for Nano Banana 3.0: the headline stays legible, the face stays consistent across scenes" width="800" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Nano Banana 3.0 is the high-efficiency image generation and editing model on the workspace: a headline written inside the poster, a face that holds across a change of scene, and up to 4K output from a natural-language brief in any language. The same studio unifies first-image ideation with in-place retouching, mask edits and multi-reference alignment. That path sits on a family Google has already documented. Nano Banana Pro, introduced as Gemini 3 Pro Image, is the official typography and 4K studio model — accurate text in multiple languages, consistent branding, up to 4K. Nano Banana 2.1 is the official efficient counterpart, with improved text rendering, multi-turn character consistency, and up to 14 reference images.&lt;/p&gt;

&lt;h2&gt;
  
  
  Key Takeaways
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Two jobs share the same canvas: the words in the frame, and the person who has to survive the next frame.&lt;/strong&gt; The workspace describes Nano Banana 3.0 as elevating visual quality, prompt adherence, character consistency and text rendering, with multi-reference input and up to 4K output. Poster typography and multi-turn character continuity are named capabilities on the same homepage.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The official family already publishes both jobs.&lt;/strong&gt; Google's 20 November 2025 Nano Banana Pro announcement puts “improved text rendering” in the lead, and states that the model can generate images with accurate text in multiple languages, at up to 4K, with consistent branding. Google's 2.1 model is documented as the more efficient counterpart, with significant improvements in visual quality, prompt adherence, multi-turn character consistency and text rendering, and support for up to 14 reference images.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;This week's comparisons are mostly about 2.1 versus other everyday models.&lt;/strong&gt; FLUX 3 and GPT Image 2.6 are the names in circulation. Those pieces argue leaderboard position or regional edits. The typography-plus-character-series job is the one this article is for, and it is the one the workspace and the official family both put in writing.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;A 15-edit drift test is a different column.&lt;/strong&gt; CHOOSETO.AI's 10 November desk-image battery measured unedited-region change across 15 iterations and put Seedream 5.5 first on that metric. Nano Banana Pro was not first on that test. This article does not treat that score as a typography or character-series result.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The &lt;a href="https://nanobananasi.com/" rel="noopener noreferrer"&gt;Nano Banana 3.0&lt;/a&gt; workspace is the path that keeps generation, mask editing and multi-turn character work in one place&lt;/strong&gt;, with Pro, Nano Banana and Nano Banana 2 listed in the same lineup.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Official Family, Workspace Path
&lt;/h2&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Capability&lt;/th&gt;
&lt;th&gt;Workspace wording for Nano Banana 3.0&lt;/th&gt;
&lt;th&gt;Official family wording&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;In-image text&lt;/td&gt;
&lt;td&gt;“Clean poster typography”; readable brand slogans and campaign headlines inside the artwork&lt;/td&gt;
&lt;td&gt;Nano Banana Pro: accurate text in multiple languages; “improved text rendering” as a lead claim&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Character continuity&lt;/td&gt;
&lt;td&gt;Multi-turn character consistency across scenes; change outfit, background, pose and lighting while keeping the face&lt;/td&gt;
&lt;td&gt;Nano Banana 2.1: official improvements in multi-turn character consistency&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;References&lt;/td&gt;
&lt;td&gt;Multi-reference style fusion; product photos, moodboards and layout references&lt;/td&gt;
&lt;td&gt;Nano Banana 2.1: up to 14 reference images; Pro: multiple reference images and consistent branding&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Resolution&lt;/td&gt;
&lt;td&gt;Up to 4K&lt;/td&gt;
&lt;td&gt;Pro: up to 4K; 2.1: 1K, 2K and 4K listed on the model documentation&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Editing&lt;/td&gt;
&lt;td&gt;Unified generation and in-place retouching; mask and brush edits that keep surrounding regions intact&lt;/td&gt;
&lt;td&gt;Official family covers generation and conversational / mask-based editing&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;  the headline job                 the face job
  ----------------                 ------------
  typography inside the poster     the same person, next scene
  official Pro lead claim          official 2.1 multi-turn claim
  multilingual, up to 4K           up to 14 references on 2.1
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Typography Is a Lead Claim, Not a Side Effect
&lt;/h2&gt;

&lt;p&gt;Google's Nano Banana Pro announcement does not bury typography in a footnote. The dek puts “improved text rendering” next to studio-quality control and world knowledge. The body states that you can generate images with accurate text in multiple languages — mockups, posters, international campaigns — and that high-fidelity visuals can keep consistent branding, at up to 4K. That is the official poster job.&lt;/p&gt;

&lt;p&gt;The workspace puts the same job on the Nano Banana 3.0 homepage: sharp, legible headlines inside promotional posters, with multiple reference images used to lock brand color and subject geometry. Pro is listed in the same lineup as the 4K commercial photography and poster-typography model — studio textures, high-control mask inpainting, and crisp in-image type.&lt;/p&gt;

&lt;p&gt;A headline that has to ship in more than one language, or that has to sit inside a 4K key visual rather than be composited later, is this family's documented work. It is not a promise that every word will land on the first try. It is the official reason typography is in the brief at all.&lt;/p&gt;

&lt;h2&gt;
  
  
  The Face Has to Survive the Next Scene
&lt;/h2&gt;

&lt;p&gt;Character consistency is the other half of a series. The workspace describes multi-turn character continuity in plain terms: lock specific features across generations and edits, then change outfits, backgrounds, poses and lighting with follow-up prompts, for storyboards, character sheets and campaigns.&lt;/p&gt;

&lt;p&gt;That wording lines up with the official 2.1 claim. Google positions 2.1 as the efficient counterpart to Pro, and lists multi-turn character consistency among the significant improvements, alongside prompt adherence and text rendering. The same documentation gives 2.1 up to 14 reference images — a concrete pack for a series that has to carry a face, a wardrobe and a set of stills from one frame to the next.&lt;/p&gt;

&lt;p&gt;A character sheet that changes rooms, clothes and cameras is a multi-turn job. A one-off portrait is not. The workspace is built for the first of those.&lt;/p&gt;

&lt;h2&gt;
  
  
  What This Week's Comparisons Actually Measured
&lt;/h2&gt;

&lt;p&gt;The last two weeks of published comparisons have mostly scored Nano Banana 2.1 against GPT Image 2.6 and FLUX 3 on everyday generation, or scored Nano Banana Pro on iterative editing. CHOOSETO.AI's 10 November test ran the same desk image through 15 edits and measured how much the unedited region drifted: Seedream 5.5 at 6.8 percent, GPT Image 2.6 at 41.4 percent, Nano Banana Pro at 44.2 percent. That battery answers a stability question. It does not answer whether a headline is legible, or whether a face holds when the brief changes the room.&lt;/p&gt;

&lt;p&gt;The typography-and-series path is the one the official family and the workspace both put in writing. The studio linked above is where that path is documented: Nano Banana 3.0 as the high-efficiency generation and editing model, with Pro in the same lineup for 4K commercial stills and poster type.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ffmveey358xmg1d7iqi84.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ffmveey358xmg1d7iqi84.jpg" alt="Official Google excerpt: Nano Banana Pro typography, multilingual text, consistent branding, and 4K" width="799" height="450"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;em&gt;Source: &lt;a href="https://blog.google/innovation-and-ai/products/nano-banana-pro/" rel="noopener noreferrer"&gt;Google DeepMind, “Introducing Nano Banana Pro”&lt;/a&gt;, official announcement of improved text rendering, accurate text in multiple languages, consistent branding, and up-to-4K output.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>ai</category>
      <category>machinelearning</category>
      <category>design</category>
      <category>nanobanana</category>
    </item>
    <item>
      <title>What is your biggest practical bottleneck when integrating MCP servers?</title>
      <dc:creator>Kling4 AI</dc:creator>
      <pubDate>Fri, 13 Nov 2026 06:07:02 +0000</pubDate>
      <link>https://dev.to/kling4ai-production/what-is-your-biggest-practical-bottleneck-when-integrating-mcp-servers-3hm7</link>
      <guid>https://dev.to/kling4ai-production/what-is-your-biggest-practical-bottleneck-when-integrating-mcp-servers-3hm7</guid>
      <description>&lt;p&gt;With Model Context Protocol (MCP) becoming the emerging standard across developer agents, IDEs, and local workflows, many engineering teams are hooking up local tools, filesystem sandboxes, and custom APIs.&lt;/p&gt;

&lt;p&gt;In your current setup, what has been the trickiest part to get right?&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Fine-grained permission scopes and human approval gates&lt;/li&gt;
&lt;li&gt;Token consumption and schema bloat across multi-tool chains&lt;/li&gt;
&lt;li&gt;State drift and error recovery when tools fail silently&lt;/li&gt;
&lt;li&gt;Cross-platform transport reliability (stdio vs SSE)&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Curious to hear how others are architecting their harness around agent tool execution!&lt;/p&gt;

</description>
      <category>productivity</category>
    </item>
    <item>
      <title>Building a Predictable AI Video Pipeline with Wan 3.0 AI: Multi-Model Routing, Multimodal Inputs, and Credit Optimization</title>
      <dc:creator>Kling4 AI</dc:creator>
      <pubDate>Sun, 01 Nov 2026 09:28:07 +0000</pubDate>
      <link>https://dev.to/kling4ai-production/building-a-predictable-ai-video-pipeline-with-wan-30-ai-multi-model-routing-multimodal-inputs-33j5</link>
      <guid>https://dev.to/kling4ai-production/building-a-predictable-ai-video-pipeline-with-wan-30-ai-multi-model-routing-multimodal-inputs-33j5</guid>
      <description>&lt;p&gt;Most generative video workflows fail in production not because the underlying diffusion or transformer weights lack visual fidelity, but because the pipeline around them is fragmented. A typical creative engineering team generates concept frames in one tool, exports PNGs to a separate 5-second video generator, runs a third-party lip-sync or Foley model for audio, and then pays for wasted high-resolution renders when camera motion drifts off-axis at second four.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Wan 3.0 AI&lt;/strong&gt; addresses this pipeline fragmentation by consolidating multi-model image synthesis, &lt;strong&gt;2-second to 30-second video generation&lt;/strong&gt;, &lt;strong&gt;7-modality reference conditioning&lt;/strong&gt;, and &lt;strong&gt;native audio synchronization&lt;/strong&gt; inside a single browser-based studio environment. By pairing deterministic credit math with explicit Draft Mode prototyping, teams can treat generative video like a repeatable engineering workflow rather than an unpredictable creative lottery.&lt;/p&gt;

&lt;p&gt;In this technical guide, we will examine how to route workloads across the six specialized models inside the studio, how to structure multimodal inputs (&lt;code&gt;Reference to Video&lt;/code&gt; vs. &lt;code&gt;Text to Video&lt;/code&gt;), and how to write time-coded prompt schemas that lock subject identity across 30-second 1080p renders.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fdi80dx4xxaz5etzlyfih.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fdi80dx4xxaz5etzlyfih.png" alt="Wan 3.0 AI Overview — Up to 30s Duration, Multimodal Reference, and Native Audio" width="800" height="420"&gt;&lt;/a&gt;&lt;/p&gt;




&lt;h2&gt;
  
  
  What Is Wan 3.0 AI? Architecture &amp;amp; Core Capabilities
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;&lt;a href="https://wan30.io/wan-studio" rel="noopener noreferrer"&gt;Wan 3.0 AI&lt;/a&gt; is an integrated multimodal video and image generation workspace that produces continuous 2s, 5s, 10s, 15s, and 30s video clips up to 1080p across six aspect ratios with built-in audio synthesis.&lt;/strong&gt; Unlike single-checkpoint web wrappers, it pairs the flagship 30-second Wan 3.0 video engine with specialized companion models for reference frame creation, typography rendering, motion control, and multilingual lip-syncing.&lt;/p&gt;

&lt;p&gt;From a systems perspective, long-horizon video generation requires solving three concurrent constraints:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Spatial Identity Preservation&lt;/strong&gt;: Ensuring a character's facial geometry, wardrobe textures, or product typography remain invariant under camera rotation and lighting shifts.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Temporal Trajectory Control&lt;/strong&gt;: Governing how subjects and cameras move across 30 seconds without collapsing into static frames or chaotic morphing.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Acoustic-Visual Alignment&lt;/strong&gt;: Synchronizing room tone, footsteps, mechanical clicks, and spoken phonemes directly to frame-level motion vectors.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Instead of forcing a single text prompt to carry all three constraints, Wan 3.0 AI decouples spatial conditioning (via uploaded start/end keyframes and multi-image reference packs) from temporal and acoustic direction (via multi-beat prompts, reference videos, and reference audio stems).&lt;/p&gt;




&lt;h2&gt;
  
  
  Multi-Model Routing: Choosing the Right Engine for Each Pipeline Stage
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Inside the Wan 3.0 AI studio, creators can switch dynamically between three video engines (&lt;code&gt;Wan 3.0&lt;/code&gt;, &lt;code&gt;Wan 3.0 Video Prime&lt;/code&gt;, and &lt;code&gt;Seedance 2.5&lt;/code&gt;) and four image engines (&lt;code&gt;Nano Banana 2&lt;/code&gt;, &lt;code&gt;Nano Banana Pro&lt;/code&gt;, &lt;code&gt;Seedream 5.0&lt;/code&gt;, and &lt;code&gt;Qwen Image 2.1&lt;/code&gt;) depending on duration, fidelity, and typography requirements.&lt;/strong&gt; Selecting the optimal model at each stage of production reduces credit overhead while maximizing visual consistency.&lt;/p&gt;

&lt;h3&gt;
  
  
  Studio Model Routing Matrix
&lt;/h3&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Model Name&lt;/th&gt;
&lt;th&gt;Primary Modality&lt;/th&gt;
&lt;th&gt;Supported Durations / Resolution&lt;/th&gt;
&lt;th&gt;Ideal Pipeline Stage &amp;amp; Technical Strength&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Wan 3.0&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Video + Native Audio&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;2s&lt;/code&gt;, &lt;code&gt;5s&lt;/code&gt;, &lt;code&gt;10s&lt;/code&gt;, &lt;code&gt;15s&lt;/code&gt;, &lt;code&gt;30s&lt;/code&gt; (&lt;code&gt;480p&lt;/code&gt; / &lt;code&gt;720p&lt;/code&gt; / &lt;code&gt;1080p&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;Flagship long-shot engine for 30s multi-beat narrative sequences and full commercial spots&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Wan 3.0 Video Prime&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Video + Native Audio&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;5s&lt;/code&gt;, &lt;code&gt;10s&lt;/code&gt;, &lt;code&gt;15s&lt;/code&gt; (&lt;code&gt;480p&lt;/code&gt; / &lt;code&gt;720p&lt;/code&gt; / &lt;code&gt;1080p&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;High-consistency narrative shots, dialogue scenes, and rapid storyboarding&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Seedance 2.5&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Multimodal Video&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;5s&lt;/code&gt;, &lt;code&gt;10s&lt;/code&gt;, &lt;code&gt;15s&lt;/code&gt; (&lt;code&gt;480p&lt;/code&gt; / &lt;code&gt;720p&lt;/code&gt; / &lt;code&gt;1080p&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;Complex motion choreography, rhythmic pacing, and multimodal audio-visual sync&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Draft Mode&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Fast Video Previz&lt;/td&gt;
&lt;td&gt;
&lt;code&gt;2s&lt;/code&gt; – &lt;code&gt;30s&lt;/code&gt; (&lt;code&gt;480p&lt;/code&gt; optimized)&lt;/td&gt;
&lt;td&gt;Low-cost camera blocking, lighting verification, and prompt timing checks&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Nano Banana 2&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Image Generation&lt;/td&gt;
&lt;td&gt;Fast multi-ratio keyframes&lt;/td&gt;
&lt;td&gt;Rapid concept exploration, mood boarding, and start-frame ideation&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Nano Banana Pro&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Image Generation&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;2K / 4K&lt;/strong&gt; Ultra-HD frames&lt;/td&gt;
&lt;td&gt;Hero product photography, hyper-detailed character sheets, and master Start/End frames&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Seedream 5.0&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Image Generation&lt;/td&gt;
&lt;td&gt;Stylized &amp;amp; editorial frames&lt;/td&gt;
&lt;td&gt;Art-directed campaigns, fashion editorials, and stylized architectural concepts&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Qwen Image 2.1&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Image + Text Editing&lt;/td&gt;
&lt;td&gt;Precision typography frames&lt;/td&gt;
&lt;td&gt;In-image brand logos, localized poster text, signage, and structured image edits&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;As detailed on the &lt;strong&gt;&lt;a href="https://wan30.io/models/wan-3-0" rel="noopener noreferrer"&gt;Wan 3.0 model specification page&lt;/a&gt;&lt;/strong&gt;, both &lt;code&gt;Text to Video&lt;/code&gt; and &lt;code&gt;Reference to Video&lt;/code&gt; modes support six native aspect ratios (&lt;code&gt;Auto&lt;/code&gt;, &lt;code&gt;16:9&lt;/code&gt;, &lt;code&gt;4:3&lt;/code&gt;, &lt;code&gt;1:1&lt;/code&gt;, &lt;code&gt;3:4&lt;/code&gt;, and &lt;code&gt;9:16&lt;/code&gt;), allowing teams to re-target assets across widescreen YouTube placements, square feed carousels, and vertical TikTok/Reels ads without cropping away key visual information.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fotbkwr1ykhnd9oqrj3wc.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fotbkwr1ykhnd9oqrj3wc.png" alt="Neo-Noir Atmospheric Lighting and Anamorphic Lens Rendering in Wan 3.0 AI" width="800" height="450"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Figure 1: Establishing high-contrast volumetric lighting and anamorphic depth-of-field in a reference keyframe before driving a 15-second or 30-second motion sequence.&lt;/em&gt;&lt;/p&gt;


&lt;h2&gt;
  
  
  Structuring Multimodal Inputs in &lt;code&gt;Reference to Video&lt;/code&gt; Mode
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Wan 3.0 AI's &lt;code&gt;Reference to Video&lt;/code&gt; workflow supports seven distinct input slots—Start Frame, End Frame, Reference Images, Reference Videos, Reference Audio, Reference Documents (up to 100 MB), and Public Reference Links—enabling deterministic scene conditioning.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;When engineering a reproducible video pipeline, relying on natural language alone introduces ambiguity. Describing &lt;em&gt;"a cobalt blue brutalist trench coat with matte orange leather gloves"&lt;/em&gt; in text can yield five different shades of blue across five generations. By supplying concrete multimodal anchors, you lock those variables down:&lt;/p&gt;
&lt;h3&gt;
  
  
  1. Boundary Frame Locking (&lt;code&gt;Start Frame&lt;/code&gt; + &lt;code&gt;End Frame&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;Uploading both a Start Frame (&lt;code&gt;t = 0s&lt;/code&gt;) and an End Frame (&lt;code&gt;t = T&lt;/code&gt;) turns open-ended generation into a constrained boundary-value problem:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Use Case A — Product Assembly / Transformation&lt;/strong&gt;: Start with an exploded view of a mechanical keyboard on a desk; end with the fully assembled keyboard glowing with RGB backlighting.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Use Case B — Seamless Loop Creation&lt;/strong&gt;: Set the exact same keyframe as both the Start Frame and End Frame on a 10-second timeline to produce an infinite background loop for web hero headers.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;
  
  
  2. Multi-Asset Context Injection (&lt;code&gt;Images&lt;/code&gt; + &lt;code&gt;Documents&lt;/code&gt; + &lt;code&gt;URLs&lt;/code&gt;)
&lt;/h3&gt;

&lt;p&gt;Unlike basic image-to-video tools that overwrite the initial frame's identity as soon as the camera pans away, Wan 3.0 AI allows you to attach supplementary &lt;strong&gt;Reference Images&lt;/strong&gt; alongside &lt;strong&gt;Reference Documents&lt;/strong&gt; (&lt;code&gt;PDF&lt;/code&gt;, &lt;code&gt;DOC&lt;/code&gt;, &lt;code&gt;PPT&lt;/code&gt;, &lt;code&gt;XLS&lt;/code&gt;, &lt;code&gt;TXT&lt;/code&gt;, &lt;code&gt;Markdown&lt;/code&gt;). You can upload a markdown storyboard specification or a PDF brand guide directly into the task context while linking a live product URL.&lt;/p&gt;
&lt;h3&gt;
  
  
  3. Motion &amp;amp; Acoustic Conditioning (&lt;code&gt;Reference Video&lt;/code&gt; + &lt;code&gt;Reference Audio&lt;/code&gt;)
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Motion Control (&lt;code&gt;/tools/motion-control&lt;/code&gt;)&lt;/strong&gt;: When a shot requires exact physical camera choreography—such as a 360-degree orbital arc or a synchronized crane-up tilt—supplying a reference motion clip ensures the generated camera path matches your edit timeline.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;AI Video Lip Sync (&lt;code&gt;/tools/ai-video-lip-sync&lt;/code&gt;)&lt;/strong&gt;: For spoken-word tutorials, founder updates, or multilingual ad variations, you can either generate native audio in real time or bind an external voiceover track for frame-accurate lip synchronization.&lt;/li&gt;
&lt;/ul&gt;


&lt;h2&gt;
  
  
  Structured Prompt Engineering: Time-Coded Schemas for 15s &amp;amp; 30s Shots
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;To prevent temporal compression (where an AI model rushes through all described actions in the first 4 seconds), prompts in Wan 3.0 AI should be written as time-coded scene schemas that explicitly separate visual geometry, camera vector math, temporal beats, and audio layers.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F1nwdod77gww9mqmgae6t.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F1nwdod77gww9mqmgae6t.png" alt="Studio Production Framing and Multi-Beat Subject Choreography" width="800" height="600"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Figure 2: Coordinating multi-subject spatial depth, wardrobe texture consistency, and controlled studio key lighting across extended durations.&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;Here is a reusable, structured prompt template that developers and technical directors can adapt for automated or manual studio runs:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="c1"&gt;# Wan 3.0 AI — 30-Second Structured Scene Schema&lt;/span&gt;
&lt;span class="na"&gt;generation_config&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;model&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;wan-3.0"&lt;/span&gt;
  &lt;span class="na"&gt;mode&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;reference-to-video"&lt;/span&gt;
  &lt;span class="na"&gt;duration&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;30s"&lt;/span&gt;
  &lt;span class="na"&gt;resolution&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;1080p"&lt;/span&gt;
  &lt;span class="na"&gt;aspect_ratio&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;16:9"&lt;/span&gt;
  &lt;span class="na"&gt;native_audio&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;

&lt;span class="na"&gt;visual_anchors&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;start_frame&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;hero_fashion_brutalist_start.png"&lt;/span&gt; &lt;span class="c1"&gt;# Generated via Seedream 5.0 / Nano Banana Pro&lt;/span&gt;
  &lt;span class="na"&gt;camera_lens&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;50mm&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;anamorphic&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;prime,&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;f/2.0,&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;subtle&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;horizontal&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;lens&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;flare"&lt;/span&gt;
  &lt;span class="na"&gt;lighting_rig&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;High-contrast&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;overcast&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;daylight&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;diffused&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;through&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;concrete&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;louvers,&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;5600K"&lt;/span&gt;

&lt;span class="na"&gt;temporal_beats&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;beat_01_0s_to_10s&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="pi"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="s"&gt;Low-angle tracking shot moving backward at walking pace in front of a subject wearing&lt;/span&gt;
    &lt;span class="s"&gt;a structured cobalt-blue wool coat and bright orange leather gloves walking along a&lt;/span&gt;
    &lt;span class="s"&gt;brutalist concrete colonnade. Wind catches the coat hem with realistic cloth physics.&lt;/span&gt;
  &lt;span class="na"&gt;beat_02_10s_to_20s&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="pi"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="s"&gt;The subject pauses at a sunlit architectural opening and turns 45 degrees toward the&lt;/span&gt;
    &lt;span class="s"&gt;camera as the lens executes a smooth dolly push-in from full-body framing to a tight&lt;/span&gt;
    &lt;span class="s"&gt;medium close-up, maintaining razor-sharp focus on facial features and fabric weave.&lt;/span&gt;
  &lt;span class="na"&gt;beat_03_20s_to_30s&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="pi"&gt;&amp;gt;&lt;/span&gt;
    &lt;span class="s"&gt;Camera pans gently rightward to reveal a sweeping brutalist plaza in the background,&lt;/span&gt;
    &lt;span class="s"&gt;holding a steady editorial hero frame for the final 5 seconds.&lt;/span&gt;

&lt;span class="na"&gt;audio_specification&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;ambient&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Crisp&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;exterior&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;wind&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;echoing&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;through&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;concrete&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;corridors"&lt;/span&gt;
  &lt;span class="na"&gt;foley&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Measured&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;leather&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;boot&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;footsteps&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;on&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;stone&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;pavement&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;stopping&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;at&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;10s,&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;subtle&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;wool&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;fabric&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;rustle"&lt;/span&gt;
  &lt;span class="na"&gt;music&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Minimalist&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;analog&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;synth&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;bass&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;pulse&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;at&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;90&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;BPM&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;entering&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;softly&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;at&lt;/span&gt;&lt;span class="nv"&gt; &lt;/span&gt;&lt;span class="s"&gt;12s"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Copy-Paste Plaintext Version for Direct Studio Input
&lt;/h3&gt;

&lt;p&gt;If you are pasting directly into the Wan 3.0 AI prompt box, flatten the schema into bracketed directives:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;[Lens &amp;amp; Lighting: 50mm anamorphic prime f/2.0, 5600K overcast daylight through brutalist concrete louvers]
[0s–10s] Low-angle Steadicam tracking backward ahead of a model in a cobalt-blue wool coat and orange leather gloves walking briskly down a concrete colonnade; realistic heavy cloth physics.
[10s–20s] Subject stops at a sunlit archway and turns 45 degrees toward lens; smooth dolly push-in from full body to medium close-up, keeping skin texture and wool weave crisp.
[20s–30s] Slow camera pan right revealing the geometric plaza behind the subject, settling into a balanced editorial hero composition.
[Audio] Crisp wind through concrete canyon, rhythmic leather footsteps on stone stopping at 10s, subtle coat fabric movement, and a deep minimalist analog synth pulse entering at 12s.
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  Deterministic Credit Math &amp;amp; Budget Forecasting
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;Wan 3.0 AI calculates credit consumption using a transparent formula: &lt;code&gt;Credits = Duration (seconds) × 5 × Resolution Multiplier&lt;/code&gt;, where &lt;code&gt;480p = 1.0x&lt;/code&gt;, &lt;code&gt;720p = 1.5x&lt;/code&gt;, and &lt;code&gt;1080p = 2.0x&lt;/code&gt;.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;For teams building repeatable content pipelines, predictable unit economics are just as important as visual quality. Here is how the credit math breaks down across subscription tiers and resolutions:&lt;/p&gt;

&lt;h3&gt;
  
  
  Unit Economics &amp;amp; Subscription Tier Breakdown
&lt;/h3&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Plan Tier&lt;/th&gt;
&lt;th&gt;Billing Rate (Annual / Monthly)&lt;/th&gt;
&lt;th&gt;Monthly Credits Included&lt;/th&gt;
&lt;th&gt;Max 5s 480p Drafts (&lt;code&gt;25 cr&lt;/code&gt;)&lt;/th&gt;
&lt;th&gt;Max 15s 1080p Videos (&lt;code&gt;150 cr&lt;/code&gt;)&lt;/th&gt;
&lt;th&gt;Max 30s 1080p Masters (&lt;code&gt;300 cr&lt;/code&gt;)&lt;/th&gt;
&lt;th&gt;Commercial Rights &amp;amp; Queue Priority&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Free Trial&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;\$0 (On Sign-Up)&lt;/td&gt;
&lt;td&gt;100 Credits&lt;/td&gt;
&lt;td&gt;4 clips&lt;/td&gt;
&lt;td&gt;—&lt;/td&gt;
&lt;td&gt;—&lt;/td&gt;
&lt;td&gt;Evaluation &amp;amp; workflow testing&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Basic&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;\$9.90/mo (\$19.90 monthly)&lt;/td&gt;
&lt;td&gt;1,200 Credits / mo&lt;/td&gt;
&lt;td&gt;48 clips&lt;/td&gt;
&lt;td&gt;8 clips&lt;/td&gt;
&lt;td&gt;4 clips&lt;/td&gt;
&lt;td&gt;Personal projects &amp;amp; standard queue&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Pro&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;\$19.90/mo (\$39.90 monthly)&lt;/td&gt;
&lt;td&gt;3,200 Credits / mo&lt;/td&gt;
&lt;td&gt;128 clips&lt;/td&gt;
&lt;td&gt;21 clips&lt;/td&gt;
&lt;td&gt;10 clips&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Full Commercial License + Priority Queue&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Ultra&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;\$59.90/mo (\$119.90 monthly)&lt;/td&gt;
&lt;td&gt;12,000 Credits / mo&lt;/td&gt;
&lt;td&gt;480 clips&lt;/td&gt;
&lt;td&gt;80 clips&lt;/td&gt;
&lt;td&gt;40 clips&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Full Commercial License + Max Concurrency&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;h3&gt;
  
  
  Three Rules for Zero-Waste Credit Optimization
&lt;/h3&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Never Debug Prompts at 1080p&lt;/strong&gt;: A 30-second render at 1080p costs &lt;strong&gt;300 credits&lt;/strong&gt;, whereas a 5-second blocking test at 480p costs &lt;strong&gt;25 credits&lt;/strong&gt; (a 12x difference). Always validate subject lighting and initial camera velocity in 2s or 5s Draft Mode first.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Use &lt;code&gt;Qwen Image 2.1&lt;/code&gt; or &lt;code&gt;Nano Banana Pro&lt;/code&gt; to Fix Spatial Errors Before Video Rendering&lt;/strong&gt;: If a product label is misspelled or a character's costume detail looks off, fix it in the static Start Frame rather than hoping the video generator corrects it mid-flight.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Isolate Post-Processing to Dedicated Tools&lt;/strong&gt;: Need to swap a background or dub a clip into Spanish, Japanese, or German? Instead of re-generating the entire 30-second 1080p video from scratch, run the existing master through the studio's standalone &lt;strong&gt;Background Remover&lt;/strong&gt; (&lt;code&gt;/tools/background-remover&lt;/code&gt;) or &lt;strong&gt;AI Video Lip Sync&lt;/strong&gt; (&lt;code&gt;/tools/ai-video-lip-sync&lt;/code&gt;).&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  Summary: From Ad-Hoc Prompting to Production Studio
&lt;/h2&gt;

&lt;p&gt;Treating AI video as an engineering discipline means controlling your inputs (via 7-modality references), routing each step to the right model checkpoint, and locking down camera and audio timing before scaling to 1080p. You can inspect the full multi-model architecture and test the 30-second pipeline directly at &lt;strong&gt;&lt;a href="https://wan30.io" rel="noopener noreferrer"&gt;wan30.io&lt;/a&gt;&lt;/strong&gt; using the 100 free trial credits included with every new account.&lt;/p&gt;

</description>
      <category>aivideogenetutorialrativeai</category>
    </item>
    <item>
      <title>A small Python brief builder for text-heavy poster prompts (Ideogram 4 workflow)</title>
      <dc:creator>Kling4 AI</dc:creator>
      <pubDate>Sun, 01 Nov 2026 01:02:53 +0000</pubDate>
      <link>https://dev.to/kling4ai-production/a-small-python-brief-builder-for-text-heavy-poster-prompts-ideogram-4-workflow-1m40</link>
      <guid>https://dev.to/kling4ai-production/a-small-python-brief-builder-for-text-heavy-poster-prompts-ideogram-4-workflow-1m40</guid>
      <description>&lt;p&gt;Prompts for posters and logos tend to grow organically: someone adds a colour, someone else pastes the headline, nobody mentions the aspect ratio, and the output comes back in the wrong shape with a misspelled date. The &lt;a href="https://ideogram4.co/ideogram-4-how-to-use?utm_source=devto&amp;amp;utm_medium=backlink&amp;amp;utm_campaign=ideogram4" rel="noopener noreferrer"&gt;How to Use Ideogram 4 page&lt;/a&gt; lists the fields a good brief should contain. This post turns that list into a tiny validator so a brief can't be sent half-finished.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F16c1e8ntjieo2yaw6b3r.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F16c1e8ntjieo2yaw6b3r.jpg" alt="Page summary" width="800" height="365"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Summary of the linked page, read 2026-11-01&lt;/em&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  The fields
&lt;/h2&gt;

&lt;p&gt;The page puts it in one sentence: "Include the exact text, visual style, subject, composition, aspect ratio, colors, and intended use." It also suggests planning drafts, HD renders, prompt variants and review checkpoints, and reviewing "text, logos, trademarks, and layout before publishing."&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fkntgx6g1gu5c4ntwm39h.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fkntgx6g1gu5c4ntwm39h.png" alt="The seven brief fields" width="800" height="365"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Self-made table: the fields with an example&lt;/em&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  The script
&lt;/h2&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;REQUIRED&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;exact_text&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;style&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;subject&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;composition&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
            &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;aspect_ratio&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;colors&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;intended_use&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;validate&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;dict&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt; &lt;span class="nb"&gt;list&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="p"&gt;]:&lt;/span&gt;
    &lt;span class="n"&gt;missing&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt; &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;k&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;REQUIRED&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt;&lt;span class="p"&gt;)]&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;exact_text&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="ow"&gt;and&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="nf"&gt;all&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="nf"&gt;isinstance&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;t&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="ow"&gt;and&lt;/span&gt; &lt;span class="n"&gt;t&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;strip&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;t&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;exact_text&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
    &lt;span class="p"&gt;):&lt;/span&gt;
        &lt;span class="n"&gt;missing&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;exact_text (empty line)&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;missing&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;render&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;dict&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt; &lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;lines&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt; / &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;'"&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;t&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;"'&lt;/span&gt; &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;t&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;exact_text&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;
    &lt;span class="nf"&gt;return &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;intended_use&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;, aspect ratio &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;aspect_ratio&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;. &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
        &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Text, exactly as written: &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;lines&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;. No other text. &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
        &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Subject: &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;subject&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;. Composition: &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;composition&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;. &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
        &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Style: &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;style&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;. Colors: &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;colors&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;.&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
    &lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="n"&gt;brief&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;exact_text&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Saturday Market&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;8-12 Town Square&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;
    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;style&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;risograph print look, two inks, slight grain&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;subject&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;a woven basket full of vegetables&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;composition&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;headline across the top, basket centred, time line at the bottom&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;aspect_ratio&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;3:4&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;colors&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;green and orange on off-white&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;intended_use&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;A3 poster for a library notice board&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="n"&gt;problems&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;validate&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;problems&lt;/span&gt; &lt;span class="ow"&gt;or&lt;/span&gt; &lt;span class="nf"&gt;render&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;p&gt;If a field is missing, the script prints what is missing instead of a prompt. That is the whole point: the gap is caught before generation, not after.&lt;/p&gt;
&lt;h2&gt;
  
  
  What it catches in practice
&lt;/h2&gt;

&lt;p&gt;The fields that go missing are rarely the creative ones. People always describe the style and the subject, because that's the fun part. What disappears is the boring information:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;aspect_ratio&lt;/strong&gt;: the poster comes back square and has to be cropped, cutting off the headline.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;intended_use&lt;/strong&gt;: without "A3 notice board", the model has no reason to keep the text large and readable from a distance.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;exact_text&lt;/strong&gt;: the brief says "a poster for the Saturday market", and the generated date is invented.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;colors&lt;/strong&gt;: two volunteers make posters for the same event in completely different palettes.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;A validator is a blunt tool, but these are exactly the gaps that a blunt tool is good at catching. It also gives a team a shared definition of "a finished brief", which saves a surprising amount of back-and-forth.&lt;/p&gt;
&lt;h2&gt;
  
  
  Why the order of the rendered prompt matters
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fmvivv4mmzk1nrz4ger1h.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fmvivv4mmzk1nrz4ger1h.png" alt="Where the script fits" width="800" height="330"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Self-made diagram: where the script fits&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;&lt;code&gt;render()&lt;/code&gt; puts the intended use and aspect ratio first, then the exact text with "No other text", and style last. Purpose and words are the things that can't be wrong; style is the thing you'll vary. Keeping the order fixed also means two briefs for different events produce prompts that are easy to compare.&lt;/p&gt;
&lt;h2&gt;
  
  
  Variants
&lt;/h2&gt;

&lt;p&gt;The page mentions prompt variants. With a dict, a variant is a one-line change:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;variant&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="o"&gt;**&lt;/span&gt;&lt;span class="n"&gt;brief&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;style&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;flat vector illustration, bold outlines&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;render&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;variant&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Only the style differs, so when you compare the two results you know what caused the difference.&lt;/p&gt;

&lt;h2&gt;
  
  
  Review
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F4tx2lj0e2td39rgixvwr.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F4tx2lj0e2td39rgixvwr.png" alt="Review before publishing" width="800" height="347"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Self-made checklist for reviewing the result&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;The checklist mirrors the page's review step: text, logos, trademarks and layout. Add one habit: save the brief as JSON next to the chosen image. When the market moves to 9-13 next season, you change one string, regenerate, and review again.&lt;/p&gt;

&lt;h2&gt;
  
  
  Extending it
&lt;/h2&gt;

&lt;p&gt;A few ideas if you use this regularly: load briefs from YAML so non-developers can edit them, add a maximum length for &lt;code&gt;exact_text&lt;/code&gt; lines (long lines are harder to render cleanly), or write the rendered prompt and the validation result into a small log so you can see which briefs produced usable posters.&lt;/p&gt;

</description>
      <category>python</category>
      <category>design</category>
      <category>ai</category>
      <category>beginners</category>
    </item>
    <item>
      <title>Planning a Multi-Shot AI Video in JSON (and Checking the Character Limits Before You Paste)</title>
      <dc:creator>Kling4 AI</dc:creator>
      <pubDate>Sat, 31 Oct 2026 01:22:06 +0000</pubDate>
      <link>https://dev.to/kling4ai-production/planning-a-multi-shot-ai-video-in-json-and-checking-the-character-limits-before-you-paste-38cd</link>
      <guid>https://dev.to/kling4ai-production/planning-a-multi-shot-ai-video-in-json-and-checking-the-character-limits-before-you-paste-38cd</guid>
      <description>&lt;p&gt;Multi-shot video editors split a clip into separate shot prompts, which is great for storytelling and slightly annoying for planning: each shot has its own character limit, the whole sequence has another, and continuity details have to be repeated in every shot. One way to manage this is to keep the storyboard in a small JSON file and run a check script before pasting anything. This post shares such a script, using the limits shown in the &lt;a href="https://gptimage2-5.org/multi-shot?utm_source=devto&amp;amp;utm_medium=backlink&amp;amp;utm_campaign=gptimage" rel="noopener noreferrer"&gt;Multi-shot Video Creator&lt;/a&gt; on GPT Image 2.5.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fmsdy0l1wzo6mx7r0go6k.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fmsdy0l1wzo6mx7r0go6k.jpg" alt="Page summary" width="800" height="364"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Summary of the linked page: gptimage2-5.org/multi-shot (read 2026-10-31)&lt;/em&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  The constraints, as shown on the page
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;The editor shows a per-shot counter (&lt;code&gt;Shot 0/500&lt;/code&gt;) and a total counter (&lt;code&gt;Total 0/1200&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;Each &lt;code&gt;@element&lt;/code&gt; token counts as 37 characters.&lt;/li&gt;
&lt;li&gt;Every shot must have a prompt.&lt;/li&gt;
&lt;li&gt;Continuity tip: repeat important visual details across shot descriptions. The page is explicit that this helps guide continuity but consistent faces, objects and transitions are not guaranteed.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;That last point is why the script below also checks that continuity phrases appear in every shot.&lt;/p&gt;
&lt;h2&gt;
  
  
  The storyboard
&lt;/h2&gt;

&lt;p&gt;The page gives an illustrative three-shot prompt: a wide view of a rainy city, a close-up of a red umbrella, and the same person walking toward a warmly lit café. Here it is expanded into a storyboard.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F8mdk91h44nxbq4qcnevw.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F8mdk91h44nxbq4qcnevw.png" alt="Example storyboard" width="800" height="301"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Self-made diagram: the three shots and their camera directions&lt;/em&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"continuity"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"red umbrella"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"grey coat"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"shots"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s2"&gt;"Wide shot of a rainy city street at dusk, wet asphalt reflecting shop signs, a woman in a grey coat with a red umbrella in the distance. Slow pan."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s2"&gt;"Close-up: the red umbrella opens above the woman in a grey coat, raindrops bouncing off the fabric."&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
    &lt;/span&gt;&lt;span class="s2"&gt;"Tracking shot from behind: the woman in a grey coat with the red umbrella walks toward a warmly lit café."&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  The check script
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;re&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;sys&lt;/span&gt;

&lt;span class="n"&gt;SHOT_MAX&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;TOTAL_MAX&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;ELEMENT_COST&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;500&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1200&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;37&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;cost&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;str&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;-&amp;gt;&lt;/span&gt; &lt;span class="nb"&gt;int&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="c1"&gt;# each @element token counts as a fixed number of characters
&lt;/span&gt;    &lt;span class="n"&gt;elements&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;re&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;findall&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;r&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;@\w+&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;plain&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;re&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;sub&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;r&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;@\w+&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;""&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nf"&gt;len&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;plain&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;ELEMENT_COST&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nf"&gt;len&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;elements&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;check&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;path&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
    &lt;span class="n"&gt;board&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;load&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;open&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;path&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;encoding&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;utf-8&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
    &lt;span class="n"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;total&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[],&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;
    &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;shot&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="nf"&gt;enumerate&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;board&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;shots&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="n"&gt;shot&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;strip&lt;/span&gt;&lt;span class="p"&gt;():&lt;/span&gt;
            &lt;span class="n"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;shot &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;: empty prompt&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="n"&gt;c&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;cost&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;shot&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="n"&gt;total&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="n"&gt;c&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;c&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;SHOT_MAX&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
            &lt;span class="n"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;shot &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;: &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;c&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;/&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;SHOT_MAX&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; characters&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;phrase&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;board&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;continuity&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;[]):&lt;/span&gt;
            &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;phrase&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;lower&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;shot&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;lower&lt;/span&gt;&lt;span class="p"&gt;():&lt;/span&gt;
                &lt;span class="n"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;shot &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;: missing continuity detail &lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;phrase&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;'"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;total&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;TOTAL_MAX&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="n"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;total: &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;total&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;/&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;TOTAL_MAX&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; characters&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;total&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;problems&lt;/span&gt;

&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;__name__&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;__main__&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;total&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;problems&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;check&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;sys&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;
    &lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;total cost: &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;total&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="se"&gt;\n&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;problems&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;OK to paste&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Run it with &lt;code&gt;python check.py storyboard.json&lt;/code&gt;. For the storyboard above the output is &lt;code&gt;OK to paste&lt;/code&gt;. Delete "grey coat" from shot 2 and the script reports the missing continuity detail, which is exactly the kind of slip that produces a different-looking character halfway through.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fcdnp9jk3d3qgykhk9fh4.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fcdnp9jk3d3qgykhk9fh4.png" alt="Workflow" width="800" height="330"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Self-made diagram: storyboard file, check, paste, review&lt;/em&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Why keep the plan outside the editor
&lt;/h2&gt;

&lt;p&gt;The page notes that drafts are saved locally in the browser, that clearing browser data can remove them, and that they do not sync to another device. A JSON file in your project folder (or a repo) survives all of that, can be diffed between versions, and can be shared with whoever reviews the storyboard.&lt;/p&gt;

&lt;h2&gt;
  
  
  What still needs a human
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fampcjc1b2bocz237ar76.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fampcjc1b2bocz237ar76.png" alt="What the script cannot check" width="800" height="350"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Self-made diagram: checks that need eyes on the result&lt;/em&gt;&lt;/p&gt;

&lt;p&gt;The script only guarantees that the text fits and that continuity phrases are present. Whether the result actually keeps the same face and the same red umbrella has to be reviewed scene by scene, as the page recommends. The page also reminds you to check the terms for the selected model before commercial use and to have permission for any reference material.&lt;/p&gt;

&lt;h2&gt;
  
  
  Wrap-up
&lt;/h2&gt;

&lt;p&gt;Treating a multi-shot prompt as structured data turns two annoying failure modes, hitting a character limit and forgetting a continuity detail, into a ten-millisecond check. The rest of the work is still creative: deciding what each shot shows and reviewing the result.&lt;/p&gt;

</description>
      <category>python</category>
      <category>ai</category>
      <category>video</category>
      <category>productivity</category>
    </item>
    <item>
      <title>Gemini 4 Carbon is #1 and gated. Here's how I'm reading the benchmark table anyway</title>
      <dc:creator>Kling4 AI</dc:creator>
      <pubDate>Fri, 30 Oct 2026 14:14:14 +0000</pubDate>
      <link>https://dev.to/kling4ai-production/gemini-4-carbon-is-1-and-gated-heres-how-im-reading-the-benchmark-table-anyway-36i3</link>
      <guid>https://dev.to/kling4ai-production/gemini-4-carbon-is-1-and-gated-heres-how-im-reading-the-benchmark-table-anyway-36i3</guid>
      <description>&lt;p&gt;Gemini 4 Carbon landed on October 28 at the top of the Artificial Analysis Intelligence Index v5.0 (59, vs 58 for Claude Opus 5.5 and 57 for GPT-6 Astra). It's only available to cyber defenders and vetted partners right now, so none of us can test it. I still found the comparison table useful, mostly as a reminder of how to read these things.&lt;/p&gt;

&lt;h2&gt;
  
  
  1. Treat a one-point lead as a tie
&lt;/h2&gt;

&lt;p&gt;Blended indexes average a lot of different tasks. A 59 vs 58 difference tells you the models are in the same tier, not that one is better for your workload.&lt;/p&gt;

&lt;h2&gt;
  
  
  2. Look for the rows where the winner loses
&lt;/h2&gt;

&lt;p&gt;Google's own table shows Opus 5.5 ahead on OSWorld-2.1 (87.2% vs 81.5%) and GPT-6 Astra ahead on FrontierSWE 2 (65.5% vs 61.2%). If your product is a computer-use agent or a coding agent, the "top model" is not the top model for you.&lt;/p&gt;

&lt;h2&gt;
  
  
  3. Find the outlier and ask why it's there
&lt;/h2&gt;

&lt;p&gt;Carbon's big gap is in security: 88.2% on SEC-bench Pro, 54.8% on ExploitGym (vs 42.4% and 34.5%), 71% on CWE-bench. The announcement says these were run with guardrails off. The outlier explains the gated release better than any press statement could.&lt;/p&gt;

&lt;h2&gt;
  
  
  4. Check whether you can actually call it
&lt;/h2&gt;

&lt;p&gt;Pricing is published ($2/M input, $10/M output, same as Argon), but there's no developer access date. A model you can't call is not part of your evaluation, no matter how it ranks.&lt;/p&gt;

&lt;h2&gt;
  
  
  What I'm doing
&lt;/h2&gt;

&lt;p&gt;Keeping my current setup and adding Carbon to my eval list as "pending." When it opens, it goes through the same small task set everything else does: a couple of refactors, a log-parsing script and one long-context summary.&lt;/p&gt;

&lt;p&gt;Curious how others handle this. Do you keep a personal eval set, or do you mostly go by public leaderboards?&lt;/p&gt;

</description>
      <category>ai</category>
      <category>llm</category>
      <category>security</category>
      <category>discuss</category>
    </item>
    <item>
      <title>A 40-line Python Linter for Ad Headlines (Before They Reach the Creative)</title>
      <dc:creator>Kling4 AI</dc:creator>
      <pubDate>Fri, 30 Oct 2026 03:19:08 +0000</pubDate>
      <link>https://dev.to/kling4ai-production/a-40-line-python-linter-for-ad-headlines-before-they-reach-the-creative-cab</link>
      <guid>https://dev.to/kling4ai-production/a-40-line-python-linter-for-ad-headlines-before-they-reach-the-creative-cab</guid>
      <description>&lt;p&gt;Headlines for ad creatives tend to get written in a document, approved in a chat thread and only seen at their real size once the image is exported. By then, fixing "The best desk lamp ever made!!" means another round of edits. This post walks through a small Python script that flags the headlines worth a second look &lt;em&gt;before&lt;/em&gt; anyone opens an editor.&lt;/p&gt;

&lt;p&gt;The rules come from AdMultiplier's short guide on how to &lt;a href="https://admultiplier.org/blog/write-short-ad-headlines?utm_source=devto&amp;amp;utm_medium=backlink&amp;amp;utm_campaign=admultiplier" rel="noopener noreferrer"&gt;write short headlines with a clear job&lt;/a&gt;: give the headline one useful detail, tie claims to evidence, and read it at the size the audience will see.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fl2s6ne9i5maigeh2yd5a.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fl2s6ne9i5maigeh2yd5a.jpg" alt="AdMultiplier headline guide summary" width="800" height="365"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Summary of the linked page: admultiplier.org/blog/write-short-ad-headlines (read 2026-10-30)&lt;/em&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  What the script should (and should not) do
&lt;/h2&gt;

&lt;p&gt;A linter cannot tell you whether a headline is good. It can tell you which ones break a rule you already agreed on. So the goal is narrow:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;count words against a house limit you choose per placement;&lt;/li&gt;
&lt;li&gt;flag claim words ("best", "guaranteed", "proven") so someone checks the evidence;&lt;/li&gt;
&lt;li&gt;flag urgency phrases that need a real deadline behind them;&lt;/li&gt;
&lt;li&gt;flag numbers and percentages, which need a source;&lt;/li&gt;
&lt;li&gt;flag headlines that are just the product name with nothing useful added.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;It does not rewrite anything. Every flag is a question for a human.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F6b6l5dgeweuf1y8c1fv3.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F6b6l5dgeweuf1y8c1fv3.png" alt="Rules the linter checks" width="800" height="362"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;The five checks and the question each one asks&lt;/em&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  The code
&lt;/h2&gt;


&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="sh"&gt;"""&lt;/span&gt;&lt;span class="s"&gt;headline_lint.py - flag ad headlines that need a second look before they go on a creative.&lt;/span&gt;&lt;span class="sh"&gt;"""&lt;/span&gt;
&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;re&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;sys&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;

&lt;span class="n"&gt;MAX_WORDS&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;8&lt;/span&gt;          &lt;span class="c1"&gt;# your own house limit; change it per placement
&lt;/span&gt;&lt;span class="n"&gt;CLAIM_WORDS&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;best&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;#1&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;number one&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;guaranteed&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;cure&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;proven&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;clinically&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;never fails&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;span class="n"&gt;URGENCY&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;hurry&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;last chance&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;act now&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;don&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;t miss&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;only today&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;lint&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;headline&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;product&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;""&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
    &lt;span class="n"&gt;notes&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[]&lt;/span&gt;
    &lt;span class="n"&gt;words&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;re&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;findall&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;r&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;[\w#&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;%-]+&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;headline&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="nf"&gt;len&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;words&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;MAX_WORDS&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="n"&gt;notes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nf"&gt;len&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;words&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; words (house limit &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;MAX_WORDS&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;) - read it at creative size&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;low&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;headline&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;lower&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
    &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;w&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;CLAIM_WORDS&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;w&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;low&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
            &lt;span class="n"&gt;notes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;claim word &lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;w&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt; - keep only if you have evidence for this exact claim&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;w&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;URGENCY&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;w&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;low&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
            &lt;span class="n"&gt;notes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;urgency phrase &lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;w&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt; - is there a real deadline?&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;re&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;search&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;r&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;\d+\s*%|\d{2,}&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;headline&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
        &lt;span class="n"&gt;notes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;number or percentage - attach the source before export&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;product&lt;/span&gt; &lt;span class="ow"&gt;and&lt;/span&gt; &lt;span class="n"&gt;product&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;lower&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;low&lt;/span&gt; &lt;span class="ow"&gt;and&lt;/span&gt; &lt;span class="nf"&gt;len&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;words&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;=&lt;/span&gt; &lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="n"&gt;notes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;headline is mostly the product name - add one useful detail&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;headline&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;count&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;!&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="n"&gt;notes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;more than one &lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;!&lt;/span&gt;&lt;span class="sh"&gt;'"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;notes&lt;/span&gt;

&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;__name__&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;__main__&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;rows&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;load&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;open&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;sys&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="n"&gt;encoding&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;utf-8&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
    &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;r&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;rows&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
        &lt;span class="n"&gt;n&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;lint&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;headline&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;product&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;""&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
        &lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;((&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;OK   &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="n"&gt;n&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;LOOK &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;r&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;headline&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;
        &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;x&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;n&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
            &lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;     - &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;x&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;


&lt;p&gt;The word limit is deliberately a constant at the top. Eight words is not a rule from anywhere; it is a placeholder. A square social image, a vertical story and a wide banner will each need their own number, and you should set it after looking at a few exports at real size.&lt;/p&gt;
&lt;h2&gt;
  
  
  Input and output
&lt;/h2&gt;

&lt;p&gt;The input is a plain JSON list, the kind you can export from a spreadsheet of headline drafts:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"headline"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"A desk lamp for small workspaces"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"product"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"desk lamp"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"headline"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"The best desk lamp ever made!!"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"product"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"desk lamp"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"headline"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Desk Lamp"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"product"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"desk lamp"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"headline"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Hurry, 70% brighter light for every desk in your home office today"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"product"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"desk lamp"&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"headline"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Warm light that clips to a shelf"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"product"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"desk lamp"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Running &lt;code&gt;python3 headline_lint.py headlines.json&lt;/code&gt; prints:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;OK   A desk lamp for small workspaces
LOOK The best desk lamp ever made!!
     - claim word 'best' - keep only if you have evidence for this exact claim
     - more than one '!'
LOOK Desk Lamp
     - headline is mostly the product name - add one useful detail
LOOK Hurry, 70% brighter light for every desk in your home office today
     - 12 words (house limit 8) - read it at creative size
     - urgency phrase 'hurry' - is there a real deadline?
     - number or percentage - attach the source before export
OK   Warm light that clips to a shelf
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The first headline is the example used in the guide itself: one concrete detail ("for small workspaces") and no promise. The fourth one shows why the checks stack: a long line, a made-up urgency and a percentage with no source behind it.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fdjx41kkpzr960sqge50j.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fdjx41kkpzr960sqge50j.png" alt="Where the linter sits in the workflow" width="800" height="330"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;Lint the list first, then design only the headlines that pass or have been justified&lt;/em&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  Where it fits in a creative workflow
&lt;/h2&gt;

&lt;p&gt;The useful moment for this script is between "list of headline ideas" and "put them on the creative". In practice:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Draft headlines in a sheet, one row per idea, with the product name in its own column.&lt;/li&gt;
&lt;li&gt;Export to JSON and run the linter.&lt;/li&gt;
&lt;li&gt;For each &lt;code&gt;LOOK&lt;/code&gt; line, either rewrite it or write down the evidence that justifies the flagged word or number.&lt;/li&gt;
&lt;li&gt;Only then place the surviving headlines on the creative and read them at their real size, which is the step the guide stresses: a headline that works in a document may feel crowded on the image.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;If you build variations with a template tool such as &lt;a href="https://admultiplier.org/?utm_source=devto&amp;amp;utm_medium=backlink&amp;amp;utm_campaign=admultiplier" rel="noopener noreferrer"&gt;AdMultiplier&lt;/a&gt;, the cleaned list is what you take into the editor, one headline per variation.&lt;/p&gt;
&lt;h2&gt;
  
  
  Extending it
&lt;/h2&gt;

&lt;p&gt;A few additions that are easy to make without turning it into a different tool:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Per-placement limits.&lt;/strong&gt; Replace &lt;code&gt;MAX_WORDS&lt;/code&gt; with a dict such as &lt;code&gt;{"square": 8, "story": 6}&lt;/code&gt; and add a &lt;code&gt;placement&lt;/code&gt; field to each row.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Your own banned list.&lt;/strong&gt; Regulated categories (health, finance) will have words that need legal review. Keep them in a separate file so the marketing and legal lists do not get mixed up.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Exit code for CI.&lt;/strong&gt; If headlines live in a repo, &lt;code&gt;sys.exit(1)&lt;/code&gt; when any row is &lt;code&gt;LOOK&lt;/code&gt; turns this into a pre-merge check.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Repetition check.&lt;/strong&gt; The guide suggests removing words that repeat the product image. A simple version compares the headline with a short description of the image and flags shared nouns.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fr5z7irqirl3y1cukembu.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fr5z7irqirl3y1cukembu.png" alt="Before-export checklist" width="800" height="383"&gt;&lt;/a&gt;&lt;br&gt;
&lt;em&gt;What still needs a human after the linter passes&lt;/em&gt;&lt;/p&gt;
&lt;h2&gt;
  
  
  Testing the linter itself
&lt;/h2&gt;

&lt;p&gt;If the script becomes part of your workflow, give it a few tests so a future edit does not silently change its behaviour. A minimal pytest file:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="kn"&gt;from&lt;/span&gt; &lt;span class="n"&gt;headline_lint&lt;/span&gt; &lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;lint&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;test_clean_headline_passes&lt;/span&gt;&lt;span class="p"&gt;():&lt;/span&gt;
    &lt;span class="k"&gt;assert&lt;/span&gt; &lt;span class="nf"&gt;lint&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;A desk lamp for small workspaces&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;desk lamp&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="p"&gt;[]&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;test_claim_word_is_flagged&lt;/span&gt;&lt;span class="p"&gt;():&lt;/span&gt;
    &lt;span class="k"&gt;assert&lt;/span&gt; &lt;span class="nf"&gt;any&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;best&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;n&lt;/span&gt; &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;n&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="nf"&gt;lint&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;The best lamp&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;lamp&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;test_name_only_is_flagged&lt;/span&gt;&lt;span class="p"&gt;():&lt;/span&gt;
    &lt;span class="k"&gt;assert&lt;/span&gt; &lt;span class="nf"&gt;any&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;product name&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;n&lt;/span&gt; &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;n&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="nf"&gt;lint&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;Desk Lamp&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;desk lamp&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;These three cases mirror the examples above. When you add a new rule, add one passing and one failing headline for it. It also documents, for whoever picks up the script next, what each rule is supposed to catch.&lt;/p&gt;

&lt;h2&gt;
  
  
  What it cannot check
&lt;/h2&gt;

&lt;p&gt;Passing the linter does not mean a headline is ready. Spelling of product names, offer conditions, image rights and how the line breaks on the final creative still need a person looking at the exported file. Treat the script as a way to make that review shorter, not to skip it.&lt;/p&gt;

</description>
      <category>python</category>
      <category>marketing</category>
      <category>beginners</category>
      <category>tutorial</category>
    </item>
    <item>
      <title>One narrative beat per clip: a JSON brief and a tiny validator for Vidu Q3 prompts</title>
      <dc:creator>Kling4 AI</dc:creator>
      <pubDate>Thu, 29 Oct 2026 09:48:10 +0000</pubDate>
      <link>https://dev.to/kling4ai-production/one-narrative-beat-per-clip-a-json-brief-and-a-tiny-validator-for-vidu-q3-prompts-aal</link>
      <guid>https://dev.to/kling4ai-production/one-narrative-beat-per-clip-a-json-brief-and-a-tiny-validator-for-vidu-q3-prompts-aal</guid>
      <description>&lt;p&gt;Short AI video clips fail most often for a reason that has nothing to do with the model: the prompt describes a mood, not a moment. "A cosy kitchen, a teapot, morning vibes" gives the model nothing to build a beginning, a middle and an end from.&lt;/p&gt;

&lt;p&gt;The &lt;a href="https://viduai.co/vidu-q3?utm_source=devto&amp;amp;utm_medium=backlink&amp;amp;utm_campaign=viduai" rel="noopener noreferrer"&gt;Vidu Q3 page on viduai.co&lt;/a&gt; has a compact piece of advice that fixes this: build a short scene around one narrative beat, and &lt;strong&gt;define the opening, the main action and the final moment in one focused prompt&lt;/strong&gt;. This post encodes that advice as a JSON brief, together with the clip settings the page lists, and validates it with a few lines of Python.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fuvhb2myptm8w7t9p9p9x.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fuvhb2myptm8w7t9p9p9x.jpg" alt="The Vidu Q3 page" width="800" height="528"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  What the page specifies
&lt;/h2&gt;

&lt;p&gt;From the Q3 page:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Inputs:&lt;/strong&gt; text-to-video, a first frame with an optional last frame, or multi-image references (up to nine).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Clips:&lt;/strong&gt; 4–15 seconds at 480p or 720p.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Audio:&lt;/strong&gt; optional. When enabled, include dialogue, footsteps, wind or another sound tied to the scene. You can also switch audio off and use the clip with your own music, narration and subtitles in the final edit.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Camera and pacing:&lt;/strong&gt; describe how the viewer approaches the subject, such as a wide establishing shot, a gentle push-in or a tracking view. A clear opening, main action and ending help the clip read as a complete moment.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  The brief as JSON
&lt;/h2&gt;

&lt;p&gt;A product-reveal example with all three parts of the beat, a camera line and a sound line:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"seconds"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;6&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"resolution"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"720p"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"audio"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="nl"&gt;"opening"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"A closed cardboard box on a kitchen counter in soft morning light"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="nl"&gt;"action"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Two hands open the lid and lift out a green ceramic teapot"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="nl"&gt;"ending"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"The teapot is placed on the counter, steam-free, label facing the camera"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="nl"&gt;"camera"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"slow push-in from a medium shot to a close-up"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="nl"&gt;"sound"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"cardboard rustling, a soft clink as the teapot touches the counter"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="nl"&gt;"references"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"teapot_front.jpg"&lt;/span&gt;&lt;span class="p"&gt;]}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ff3ov2uw7o97bj723vs16.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Ff3ov2uw7o97bj723vs16.png" alt="Opening, action, ending" width="800" height="330"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Each field answers one question. The opening says what we see first. The action is the one thing that happens. The ending is where the clip lands. Writing them as separate fields makes it obvious when one is missing.&lt;/p&gt;

&lt;h2&gt;
  
  
  The validator
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;sys&lt;/span&gt;

&lt;span class="n"&gt;DURATIONS&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;range&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;16&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;          &lt;span class="c1"&gt;# 4-15 s clips, as listed on the Vidu Q3 page
&lt;/span&gt;&lt;span class="n"&gt;RESOLUTIONS&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;480p&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;720p&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="n"&gt;MAX_REFS&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;9&lt;/span&gt;                      &lt;span class="c1"&gt;# "organize up to nine references"
&lt;/span&gt;
&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;build&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
    &lt;span class="n"&gt;errs&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[]&lt;/span&gt;
    &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;part&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;opening&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;action&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;ending&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;part&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt; &lt;span class="n"&gt;errs&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;missing &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;part&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;seconds&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;DURATIONS&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;errs&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;seconds&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;s outside 4-15 s&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;resolution&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;RESOLUTIONS&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;errs&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;resolution &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;resolution&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="nf"&gt;len&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;references&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;[]))&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;MAX_REFS&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;errs&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="nf"&gt;len&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;references&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; references &amp;gt; &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;MAX_REFS&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;audio&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="ow"&gt;and&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;sound&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt; &lt;span class="n"&gt;errs&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;audio on but no sound described&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;audio&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="ow"&gt;and&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;sound&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt; &lt;span class="n"&gt;errs&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;sound described but audio off&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;prompt&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;. &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;k&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;opening&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;action&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;ending&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;. Camera: &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;camera&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;.&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;audio&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="ow"&gt;and&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;sound&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt; &lt;span class="n"&gt;prompt&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt; Sound: &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;sound&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;.&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;errs&lt;/span&gt;

&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;__name__&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;__main__&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;path&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;sys&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;:]:&lt;/span&gt;
        &lt;span class="n"&gt;b&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;load&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;open&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;path&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
        &lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;errs&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;build&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;== &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;path&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;: &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;seconds&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;s &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;resolution&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; audio=&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;on&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;b&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;audio&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;off&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;   &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;p&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;   &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;OK&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="n"&gt;errs&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;FIX: &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;; &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;errs&lt;/span&gt;&lt;span class="p"&gt;)))&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The rules are deliberately few. The three beat fields must exist, the duration and resolution must be ones the page lists, and the reference count must stay within nine. The audio rules come straight from the page's advice: if audio is on, describe sound tied to the action; if you plan to add your own soundtrack, switch it off rather than describing sounds that will be replaced.&lt;/p&gt;

&lt;h2&gt;
  
  
  Output
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;== reveal.json: 6s 720p audio=on
   A closed cardboard box on a kitchen counter in soft morning light. Two hands open the lid and lift out a green ceramic teapot. The teapot is placed on the counter, steam-free, label facing the camera. Camera: slow push-in from a medium shot to a close-up. Sound: cardboard rustling, a soft clink as the teapot touches the counter.
   OK
== reveal_draft.json: 20s 720p audio=on
   A cardboard box on a kitchen counter. The teapot on the counter. Camera: orbit.
   FIX: missing action; 20s outside 4-15 s; audio on but no sound described
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The draft fails three ways, and each failure matches a common real mistake. "20 seconds" usually means the idea is two beats, not one; split it into two clips. A missing action means the prompt only describes two still states. And audio on without a sound line leaves the model to invent ambience you did not ask for.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fyb9p9wa15ljsd935beh5.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fyb9p9wa15ljsd935beh5.png" alt="What the validator flagged" width="799" height="300"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Choosing settings for a first pass
&lt;/h2&gt;

&lt;p&gt;The validator accepts any duration from 4 to 15 seconds, but the beat itself suggests a length. An unboxing like the teapot example needs time for hands to open a lid and place an object: six seconds is plenty. A reaction shot, a glance or a smile, can be four. Starting short keeps the clip focused on its one beat and makes it cheaper to iterate.&lt;/p&gt;

&lt;p&gt;For the first pass, 480p is often enough to judge whether the action reads correctly. Move to 720p once the beat works.&lt;/p&gt;

&lt;h2&gt;
  
  
  From one beat to a sequence
&lt;/h2&gt;

&lt;p&gt;The page describes developing separate shots from the same creative direction and arranging them with your own editing tools. With JSON briefs, a sequence is just a list of files: &lt;code&gt;01-reveal.json&lt;/code&gt;, &lt;code&gt;02-pour.json&lt;/code&gt;, &lt;code&gt;03-cup.json&lt;/code&gt;. Each one is validated on its own, and each one stays a single beat. Keeping the same reference images across them helps the product look the same from clip to clip, although you still need to review every clip.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why validate a prompt at all?
&lt;/h2&gt;

&lt;p&gt;It can seem like overkill to run a script over a four-sentence prompt. The value shows up when several people write briefs, or when you write twenty of them for a campaign. A reviewer can read the JSON and see at a glance whether every clip has an action and an ending, without opening the workspace or spending anything on generation. And when a clip turns out badly, the brief tells you exactly what was asked for, which makes it much easier to decide whether the problem was the brief or the result.&lt;/p&gt;

&lt;p&gt;The JSON also makes small experiments clean. To test whether a tracking view works better than a push-in, copy the file, change only the &lt;code&gt;camera&lt;/code&gt; field, and you have two briefs that differ in exactly one way.&lt;/p&gt;

&lt;h2&gt;
  
  
  What to check after generation
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Does the clip start at the opening and land on the ending?&lt;/li&gt;
&lt;li&gt;Is the action visible and in the right order?&lt;/li&gt;
&lt;li&gt;Does the camera do what the camera line says?&lt;/li&gt;
&lt;li&gt;If audio is on, are the sounds tied to what you see?&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fyd1yfawyxtnplx4mlqoi.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fyd1yfawyxtnplx4mlqoi.png" alt="Review checklist" width="800" height="377"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Summary
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;One clip, one beat: opening, main action, final moment.&lt;/li&gt;
&lt;li&gt;Encode the page's settings: 4–15 s, 480p or 720p, up to nine references.&lt;/li&gt;
&lt;li&gt;Audio on means describing sound tied to the action; otherwise switch it off.&lt;/li&gt;
&lt;li&gt;Long ideas become several validated briefs, not one long prompt.&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>python</category>
      <category>json</category>
      <category>video</category>
      <category>ai</category>
    </item>
    <item>
      <title>Lint your multi-shot video plan before you submit it: a tiny JSON + Python checker</title>
      <dc:creator>Kling4 AI</dc:creator>
      <pubDate>Thu, 29 Oct 2026 09:02:24 +0000</pubDate>
      <link>https://dev.to/kling4ai-production/lint-your-multi-shot-video-plan-before-you-submit-it-a-tiny-json-python-checker-51p</link>
      <guid>https://dev.to/kling4ai-production/lint-your-multi-shot-video-plan-before-you-submit-it-a-tiny-json-python-checker-51p</guid>
      <description>&lt;p&gt;Multi-shot video editors ask you to split one idea into several shots, each with its own prompt and duration. That is a good discipline, but it adds new ways to fail: one shot over the character limit, a total that runs past the maximum duration, or a shot that quietly forgets the detail that ties the sequence together.&lt;/p&gt;

&lt;p&gt;The &lt;a href="https://gptimage2-5.org/multi-shot?utm_source=devto&amp;amp;utm_medium=backlink&amp;amp;utm_campaign=gptimage" rel="noopener noreferrer"&gt;Multi-shot Video Creator on GPT Image 2.5&lt;/a&gt; shows its limits right in the editor, which makes them easy to encode. This post keeps the shot plan in a JSON file and checks it with a short Python script before anything is submitted.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Feg8qla929tow7zpfpxwo.jpg" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Feg8qla929tow7zpfpxwo.jpg" alt="The multi-shot editor" width="800" height="528"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  The limits the editor shows
&lt;/h2&gt;

&lt;p&gt;Reading the editor and the text below it, these are the rules that matter for a plan:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Each shot has a description field with a counter of &lt;strong&gt;500 characters per shot&lt;/strong&gt; and &lt;strong&gt;1,200 in total&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Each @element token counts as 37 characters.&lt;/strong&gt; Elements are reusable items from the element library.&lt;/li&gt;
&lt;li&gt;The duration counter reads &lt;strong&gt;Total 5/15s&lt;/strong&gt; for a single default shot, so the whole sequence has a &lt;strong&gt;15-second&lt;/strong&gt; ceiling.&lt;/li&gt;
&lt;li&gt;The editor refuses to continue until &lt;strong&gt;each shot has a prompt&lt;/strong&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The page also gives advice that is not a hard limit but matters just as much: keep each shot focused, and repeat important visual details across shot descriptions, because consistent faces, objects and transitions are not guaranteed.&lt;/p&gt;

&lt;h2&gt;
  
  
  The plan as JSON
&lt;/h2&gt;

&lt;p&gt;The page's own illustrative prompt is a three-shot sequence: a wide rainy city, a close-up of a red umbrella, the same person walking into a warmly lit café. Expanded into a plan file:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"repeat"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"red umbrella"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="nl"&gt;"shots"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"seconds"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"prompt"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Wide shot of a rainy city street at dusk, wet pavement reflecting shop lights, a woman in a long grey coat with a red umbrella walks away from the camera."&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"seconds"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"prompt"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Close-up of the red umbrella from above, raindrops bouncing off the fabric, the grey coat sleeve visible at the edge of the frame."&lt;/span&gt;&lt;span class="p"&gt;},&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"seconds"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="mi"&gt;5&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nl"&gt;"prompt"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;"Medium shot: the same woman in the long grey coat closes the red umbrella and steps into a warmly lit cafe, the camera stays outside behind the rainy window."&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
 &lt;/span&gt;&lt;span class="p"&gt;]}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The &lt;code&gt;repeat&lt;/code&gt; list is my addition. It names the details that must appear in every shot for continuity, following the page's advice to repeat important visual details.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fqkhr5vd5qtc4ic5r82jl.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fqkhr5vd5qtc4ic5r82jl.png" alt="From idea to shot plan" width="800" height="330"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  The checker
&lt;/h2&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;re&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;sys&lt;/span&gt;

&lt;span class="n"&gt;SHOT_MAX&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;TOTAL_MAX&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;SECONDS_MAX&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;500&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;1200&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;15&lt;/span&gt;   &lt;span class="c1"&gt;# limits shown in the multi-shot editor
&lt;/span&gt;&lt;span class="n"&gt;ELEMENT_COST&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;37&lt;/span&gt;                                   &lt;span class="c1"&gt;# "each @element token counts as 37 characters"
&lt;/span&gt;
&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;counted_len&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
    &lt;span class="n"&gt;tokens&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;re&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;findall&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;r&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;@\w+&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nf"&gt;len&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;re&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;sub&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;r&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;@\w+&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="sh"&gt;""&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;ELEMENT_COST&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="nf"&gt;len&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;tokens&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt; &lt;span class="nf"&gt;len&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;tokens&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;

&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;check&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;plan&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
    &lt;span class="n"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;total_chars&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;total_secs&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[],&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;
    &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;shot&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="nf"&gt;enumerate&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;plan&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;shots&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;],&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
        &lt;span class="n"&gt;n&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;k&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;counted_len&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;shot&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;prompt&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;])&lt;/span&gt;
        &lt;span class="n"&gt;total_chars&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="n"&gt;n&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="n"&gt;total_secs&lt;/span&gt; &lt;span class="o"&gt;+=&lt;/span&gt; &lt;span class="n"&gt;shot&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;seconds&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
        &lt;span class="n"&gt;flag&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sh"&gt;""&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;n&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;=&lt;/span&gt; &lt;span class="n"&gt;SHOT_MAX&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;  &amp;lt;- over &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;SHOT_MAX&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
        &lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;shot &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;: &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;shot&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="s"&gt;seconds&lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="si"&gt;:&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;s  &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;n&lt;/span&gt;&lt;span class="si"&gt;:&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; chars (&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;k&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; @element)&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;flag&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="n"&gt;shot&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;prompt&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;].&lt;/span&gt;&lt;span class="nf"&gt;strip&lt;/span&gt;&lt;span class="p"&gt;():&lt;/span&gt; &lt;span class="n"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;shot &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; has no prompt&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;n&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;SHOT_MAX&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;shot &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; is &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;n&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; chars&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
        &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="n"&gt;detail&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;plan&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;repeat&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;[]):&lt;/span&gt;
            &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;detail&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;shot&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;prompt&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="ow"&gt;and&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;@&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="ow"&gt;in&lt;/span&gt; &lt;span class="n"&gt;shot&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;prompt&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;]:&lt;/span&gt;
                &lt;span class="n"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;shot &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;i&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; does not repeat &lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;detail&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;'"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;total: &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;total_secs&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;s / &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;SECONDS_MAX&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;s, &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;total_chars&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; / &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;TOTAL_MAX&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; chars&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;total_secs&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;SECONDS_MAX&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;total duration &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;total_secs&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt;s&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;total_chars&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;TOTAL_MAX&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;problems&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;append&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;total &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;total_chars&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; chars&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;problems&lt;/span&gt;

&lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="n"&gt;__name__&lt;/span&gt; &lt;span class="o"&gt;==&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;__main__&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;
    &lt;span class="n"&gt;plan&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;json&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;load&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nf"&gt;open&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;sys&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;argv&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;]))&lt;/span&gt;
    &lt;span class="n"&gt;issues&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;check&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;plan&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="nf"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;OK&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt; &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="ow"&gt;not&lt;/span&gt; &lt;span class="n"&gt;issues&lt;/span&gt; &lt;span class="k"&gt;else&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;FIX:&lt;/span&gt;&lt;span class="se"&gt;\n&lt;/span&gt;&lt;span class="s"&gt;- &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="se"&gt;\n&lt;/span&gt;&lt;span class="s"&gt;- &lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;join&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;issues&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Two details are worth pointing out. First, the character count replaces each &lt;code&gt;@element&lt;/code&gt; token with 37 characters, as the editor says it does, so a short-looking prompt full of elements is measured correctly. Second, the continuity check accepts a shot that uses an element token instead of the literal phrase, since an element is a way of carrying the same subject across shots.&lt;/p&gt;

&lt;h2&gt;
  
  
  Running it
&lt;/h2&gt;

&lt;p&gt;On the plan above:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;shot 1:  4s  154 chars (0 @element)
shot 2:  4s  130 chars (0 @element)
shot 3:  5s  157 chars (0 @element)
total: 13s / 15s, 441 / 1200 chars
OK
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Then a second draft, rewritten with elements and slightly longer shots:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;shot 1:  6s  193 chars (2 @element)
shot 2:  5s   64 chars (0 @element)
shot 3:  6s  166 chars (2 @element)
total: 17s / 15s, 423 / 1200 chars
FIX:
- shot 2 does not repeat 'red umbrella'
- total duration 17s
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F0ymfbx1d0psenuj1inc0.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F0ymfbx1d0psenuj1inc0.png" alt="What the checker caught" width="800" height="301"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Both problems are typical. The durations crept up from 13 to 17 seconds because each shot got "just one more second". And the close-up in shot 2 lost its subject: "raindrops on fabric" no longer says whose fabric, or that it is red. The model has no reason to keep the umbrella red if the prompt does not ask for it.&lt;/p&gt;

&lt;h2&gt;
  
  
  Why lint at all?
&lt;/h2&gt;

&lt;p&gt;You could notice these issues in the editor, and the editor will block some of them. The value of a plan file is elsewhere:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Versioning.&lt;/strong&gt; The JSON lives next to your project. You can diff draft 1 against draft 2 and see exactly which shot changed.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Reuse.&lt;/strong&gt; For a series of short videos with the same character, the &lt;code&gt;repeat&lt;/code&gt; list becomes a shared continuity rule.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Review.&lt;/strong&gt; A teammate can read the plan without opening the editor or spending credits.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Extending the plan file
&lt;/h2&gt;

&lt;p&gt;Because the plan is plain JSON, it is easy to grow with your workflow. A few fields that have been useful in practice:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;camera&lt;/code&gt; per shot, so the camera instruction is visible at a glance and you can check that two neighbouring shots do not both say "slow push-in".&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;purpose&lt;/code&gt; per shot, a one-line note such as "establish the place" or "show the decision", which makes reviews faster than reading full prompts.&lt;/li&gt;
&lt;li&gt;A top-level &lt;code&gt;aspect&lt;/code&gt; field, so the plan records which frame shape it was written for.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;None of these are sent to the editor; they are notes for you and your team. The checker ignores unknown fields, so adding them costs nothing.&lt;/p&gt;

&lt;h2&gt;
  
  
  What the checker cannot do
&lt;/h2&gt;

&lt;p&gt;It checks the plan, not the result. After generation, the page's advice still applies: review each scene before using the sequence, and revise scenes where continuity matters. The FAQ states plainly that multi-shot creation does not guarantee consistent characters. Use the same character details, clothing and style across shots, use reference options where the editor supports them, and look at every transition.&lt;/p&gt;

&lt;p&gt;The checker also does not know which model you pick. The page notes that reference inputs, aspect ratios and resolutions depend on the selected model, so check the settings shown in the editor before you submit.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fjskxh401hcl5vfxpldyz.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fjskxh401hcl5vfxpldyz.png" alt="Before you submit" width="800" height="380"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  Summary
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;Keep the shot plan in a JSON file with durations and prompts.&lt;/li&gt;
&lt;li&gt;Encode the editor's limits: 500 per shot, 1,200 total, @element = 37, 15 s total.&lt;/li&gt;
&lt;li&gt;Add a &lt;code&gt;repeat&lt;/code&gt; list for continuity details and check every shot against it.&lt;/li&gt;
&lt;li&gt;Lint before submitting; review transitions after generating.&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>python</category>
      <category>json</category>
      <category>video</category>
      <category>ai</category>
    </item>
  </channel>
</rss>
