pod docs

Prompting: how to talk so pod hears you

A handful of habits โ€” front-loading your brief, naming outcomes instead of mechanisms, and scoping your notes โ€” turn pod from a machine you argue with into a crew that reads your mind.

pod understands plain language, in any language. There is no secret syntax to learn. But like a real crew, it works best when you brief it the way a director briefs a set: say what you want the audience to feel, say it early, and be precise about which shot you mean. This page is the craft of that. (For how conversation works mechanically โ€” gates, the front desk, what Enter does โ€” see talking to pod.)

Front-load the brief

Before anything starts, pod asks for what it needs โ€” duration, language, look, dialogue style, shape (16:9 wide, 9:16 vertical, 1:1 square). It only asks about the blanks. So the fastest sessions start with a first message that fills the blanks in advance:

BeforeAfter
"make a teaser of my script"
โ†’ pod has to ask: how long? what language? wide or vertical? what look?
"90-second telugu teaser of the attached script, vertical, moody like a Rajamouli intro, protect the ending"
โ†’ zero questions; straight to the script gate

Take that "after" apart โ€” it's the anatomy of a good brief:

Outcome, not mechanism

You don't have to know how the images get made. Say what it should feel like and let the crew translate. "Moody, like a Rajamouli intro" works better than trying to guess technical settings โ€” pod's cinematographer knows what that means and carries it into every prompt. When you do want to speak precisely, pod has a full craft vocabulary โ€” shots, lenses, light, grades โ€” on the camera language page.

Style vs direction

Two different dials, and pod treats them separately:

You can set either in the brief (--style "โ€ฆ" and --direction "โ€ฆ" exist if you like flags, but plain words do the same job). If a scene looks right but feels wrong, you want direction, not style.

Scoped notes vs standing rules

At every gate, pod listens for how big your note is:

Tip: If you catch yourself typing the same note at three gates in a row, promote it: "from now on, โ€ฆ" โ€” and never type it again.

Brief the critics too

In assisted and autopilot modes, AI critics inspect every image and clip. They judge against your intent โ€” so tell them what your intent is. Two directions worth giving:

Teasers protect endings โ€” if you say so

Tell pod "tease it, never reveal the ending" (or just "protect the ending" in the brief) and it will build the whole teaser around withholding. And a house note on voice: in trailers and teasers, characters speak in their own voices โ€” pod won't put a narrator over your film unless you ask for one.

Choosing how people speak

Three dialogue styles, asked upfront (or set with --dialogue):

ChoiceWhat it meansWhen it fits
nativeLines performed on camera โ€” lips move with the wordsScreenplays with real scenes and dialogue (this is the house default for screenplays)
voVoice-over narration laid over the footageExplainers, documentary formats, narrated stories (the default for narration formats)
silentNo speech at allMood pieces, music-driven teasers, ambient work

None of these are final: after delivery you can dub a real recording over any shot โ€” see your own media.

"Assume" โ€” the skip button

Anything you leave open, pod lists as an assumption and waits for your explicit OK โ€” nothing renders until you say go. If you'd rather not review that list, say "assume" at the question, or put "you're ok to assume" right in the brief, and pod fills the blanks itself. After a couple of productions it gets even easier: pod remembers your habits and offers "your usual" (telugu ยท 9:16) โ€” still confirmed, never applied silently.

"No" is always free

A bare "no" at any gate never spends money. pod stops and asks what to change. You cannot decline your way into a bill โ€” the only thing that spends credits is footage you approved at the cost gate.

A brief in the wild

โฏ 90-second telugu teaser of the attached script, vertical, moody like a Rajamouli intro, protect the ending. you're ok to assume the rest
Got it โ€” 90s ยท telugu ยท 9:16 ยท teaser ยท ending protected.
Assuming: native dialogue (it's a screenplay) ยท 1080p delivery.
Say go and I'll start on the script.
  (one message, zero follow-up questions)
Note: The habits on this page work at every gate, not just the first message โ€” a scoped note at the shot plan ("scene 2 shot 2 should be a top shot") is first-class, and edit notes at the final screening ("cut the first 3 seconds", "pacier") are free recuts. See the gates for the full walkthrough.