User Guide

AI Models

Complete reference of all AI models available in OpenStory

OpenStory provides a curated set of models for script analysis, image generation, motion/video generation, and music generation. LLM calls use OpenRouter (directly or through fal's compatible route), images and videos use Prism, and music uses Fal.ai.

Provider Routing

  • FAL_KEY covers music generation and can also cover LLM calls routed through fal.
  • OPENROUTER_KEY provides direct OpenRouter access for LLM models and is optional when a fal key is available.

Keys saved under Settings → API Keys are scoped to the current team. A deployment can also provide platform-wide fallback keys through environment variables.

Script Analysis Models

These LLM models analyze your script, extract scenes, characters, and locations, and generate prompts. You can select multiple models to generate parallel sequences for comparison.

ModelVendorContext WindowCredits / 1M tokens (input/output)
GPT-5.6 LunaOpenAI1.05M tokens20 / 120 (default)
DeepSeek V4 FlashDeepSeek1.05M tokens20 / 120 (scene split)

Image Generation Models

These models create the visual images for each scene. You can select multiple models to generate variant images for comparison.

ModelVendorDefault OutputCredits / imageNotes
Nano Banana 2Google1K30Fast generation and editing
Nano Banana ProGoogle1K50Enhanced realism and typography
GPT Image 2OpenAI1K, low quality10Default; strong text/UI rendering

Edit Endpoints

Most image models support reference image editing via dedicated edit endpoints. This allows the AI to use character and location reference images when generating scenes, improving visual consistency.

Motion/Video Models

These models animate still images into video clips.

ModelVendorCredits / secondNotes
Seedance 2.0ByteDance30Native audio
Seedance 2.0 FastByteDance20Faster generation
Wan 2.6Alibaba20Native audio
Wan 2.6 FlashAlibaba10Faster generation
MiniMax H3MiniMax10Default; native audio

Aspect Ratio Compatibility

Not all motion models support all aspect ratios. OpenStory automatically filters to show only compatible models and will switch to a compatible default if your current model doesn't support the selected ratio.

Audio Support

Some motion models can generate audio alongside video. OpenStory checks each model's capabilities to determine audio support.

Music & Audio Models

ModelVendorMax DurationCredits / generationTypeLicense
ACE-Step 1.5ACE Studio600s (10 min)10MusicOpen Source
ACE-StepACE Studio240s (4 min)10MusicOpen Source

Music vs. Sound Effects

Both models generate background music from text prompts, optional tags, and optional lyrics. ACE-Step 1.5 is the default.

Capabilities

FeatureACE-Step 1.5ACE-Step
Prompt-basedYesYes
Lyrics supportYesYes
InstrumentalYesYes
Long-form10 minutes4 minutes

One US dollar corresponds to 100 OpenStory credits. All prices above use the OpenStory product tariff.