Tools / Poetry Cinema

Poetry Cinema turns any poem into a fully assembled 30-second vertical short film. The pipeline takes your poem from raw text all the way to a finished micro-cinema video — scene breakdown, AI storyboard images, animated video clips, text overlays, voiceover narration, ambient sound, and final assembly with transitions and fade to black.

The production follows a four-phase workflow with review gates between each phase. Scene breakdown assigns timing, emotional beats, and colour phases to each line. Storyboard generation creates visual references for every scene. Video generation animates each storyboard into a clip. The final assembly stitches everything together with breathing text overlays, narration, and sound design.

What you can do

Break any poem into timed scenes with emotional arcs and colour phases
Define recurring characters with multi-angle portrait turnaround sheets for visual consistency
Generate storyboard images for each scene in a consistent visual style
Animate storyboard images into short video clips
Add text overlays, voiceover narration, and ambient sound to each clip
Assemble the final vertical film with transitions and fade to black
Resume an existing project and pick up from where you left off

Who it's for

Poets, spoken word artists, filmmakers, content creators, and literary organisations who want to turn written work into shareable vertical video. Also useful for publishers creating book trailers, arts organisations producing digital content, and educators bringing poetry to life for students.

How to use it

If returning to a project, use resume_project first — it reads your saved files and tells you the next step
Use create_project to set visual style, or skip straight to break_poem with your poem text
Review the scene breakdown, then use write_script for detailed visual direction per scene
Progress through generate_storyboard, generate_scenes, add_layers, and assemble_film with reviews between each phase

Getting started

No API key required to get started — the tool uses the platform's default image and video models.

Resume Project

Check what already exists for a project and determine the next step. Agent reads user files via MCP tools and passes contents here. Returns what's ready, what's missing, and the next skill to call with pre-loaded inputs.

Returns: Project state summary with next_skill and pre-loaded next_inputs ready to pass to the next call.

Create Project

Set up a new poetry cinema project with production bible configuration. Uses scratch cinema defaults or parses an uploaded production bible document to extract visual style, colour worlds, and film rules.

Returns: Project configuration saved to files with visual style and film rules

Define Persona

Define a recurring or per-poem character and generate turnaround sheets (front/left/right/back portraits) for visual consistency across scenes. Uses the persona-generator tool for turnaround sheet creation. Takes ~70s per persona. Async — poll with get_job_result.

Returns: Persona definition with turnaround sheet URLs saved to project files. Render sheets inline via sheet_url.

Break Poem into Scenes

Divide a poem into ~12 scenes with timing, emotional arc (4-beat: hook/setup/disruption/release), and colour phase assignments. Poem text can be passed directly or read from an uploaded file. Saves scenes.json to project files.

Returns: Scene breakdown with timing, emotional beats, and colour phases saved to scenes.json

Write Script

Generate the full storyboard document from the scene breakdown — detailed visual descriptions, camera direction, sound design, and text treatment per scene. Reads scenes.json from project files. Saves script.json. This completes Phase 1 (Pre-production) — user should review before proceeding.

Returns: Storyboard script saved to script.json. User should review before proceeding to storyboard generation.

Generate Storyboard Images

Generate one storyboard image per scene in the project's visual style. Includes persona references for character consistency. Use skip_scenes for user-uploaded images. Completes Phase 2 — review before proceeding.

Returns: Storyboard images saved to project files. User should review before proceeding to video generation.

Generate Scene Video Clips

Animate each storyboard image into a short video clip. Takes 2-5 minutes. Runs asynchronously — returns a job_id, poll with get_job_result until complete. If videos are still generating when the job completes, use check_scenes to poll for them.

Returns: Completed video clips and/or pending video references. Use check_scenes to poll for pending videos.

Check Pending Scene Clips

Poll for pending video clips that are still generating. Pass the pending_videos array from generate_scenes output. Returns completed clips and any still-pending references.

Returns: Completed clips saved to project files, plus any still-pending references for further polling

Add Text, Voice & Sound

Composite breathing text overlays, voiceover narration, and ambient sound onto each video clip. Completes Phase 3 — review layered clips before final assembly.

Returns: Layered clips with text, voiceover, and sound design. User should review before final assembly.

Assemble Final Film

Stitch all layered clips into the final vertical micro-cinema film. Adds transitions (brief breath between scenes), holds final frame with last poetry line, fades to black. This completes Phase 4 (Final) — the finished film.

Returns: The finished vertical micro-cinema film. Show film_page to the user for sharing and download.

List Models

List available models for this tool, sorted by popularity. Returns provider details and pricing.

Returns: List of available models with pricing and provider info