Start a new faceless video project. format 'shorts' = 1080x1920 vertical (<60s), 'long' = 1920x1080. Returns the project id used by all other tools, plus the quality guide you should follow when writing the script.

Set (or replace) the full scene list: per scene one narration passage and one image prompt. You are the writer — bring a hook, concrete details, and one idea per scene. Returns pacing/quality warnings; fix them before generating assets.

Synthesize narration audio for every scene (or the listed sceneIds) with voicebox TTS. Returns per-scene durations.

Generate one image per scene (or the listed sceneIds) with CodexImage, at the project aspect ratio. The project imageStyle is appended to every prompt for visual consistency.

Build burned-in captions from the narration audio. Uses whisper word timestamps when available (mlx_whisper or whisper CLI), otherwise proportional timing. Shorts get karaoke word-highlight. Run after generate_narration.

Render the final video: Ken Burns motion per scene (alternating direction), concat, optional caption burn-in, optional background music (looped, ducked), loudness-normalized to -14 LUFS. Returns the output path.

List available voicebox voice profiles (name + id) so you can pick a fitting narrator.

Generate a text-free thumbnail image via CodexImage (1536x1024 landscape for long-form, 1024x1536 for shorts). Prompt one dramatic subject with strong lighting — add title text later in an editor.

Show a project's pipeline state: which scenes have narration/images, captions, output.