samuraigpt/muapi-storyboard

Storyboard Generator

Generate N keyframes for a short story or scene sequence (image only, no video).

Inputs

| Name | Type | Required | Default | Description | |:---|:---|:---|:---|:---| | premise | text | yes | — | One-line story premise (e.g. "lonely robot finds a tiny mechanical bird friend"). | | scenes | int | no | 6 | Number of keyframes to produce. | | style | text | no | cinematic, photoreal, soft lighting, 16:9 | Visual style tags applied to every keyframe. |

Steps

Use the plan to dispatch all N keyframes in a single parallel layer.

1. Decompose premise into {{scenes}} story beats with a clear arc: setup → inciting moment → escalation → climax → resolution.
   • Each beat gets a one-paragraph visual description.
   • Maintain character / object continuity across beats (same character appearance, same world).
2. For each beat, create a muapi image generate node (model=nano-banana-2, aspect_ratio=16:9):
   • Prompt = "<beat description>. {{style}}".
   • Tier: balanced (these are reference keyframes, not finals).
   • Aspect ratio: 16:9.
3. Run the plan in parallel (no depends_on between keyframes).
4. Return the asset ids in beat order with a one-line caption per scene.

Notes

• Don't animate, upscale, or add audio — this skill is keyframes only. If the user wants video, suggest the music-video skill afterward.
• For consistency, repeat character description verbatim in every prompt ("a small rusty humanoid robot with…") rather than relying on the model to remember.

Trigger Keywords

storyboard, keyframes, scene sequence, story panels

Notes for the Executing Agent

• This recipe is LLM-orchestrated: read each phase, gather any missing inputs from the user, then call muapi CLI commands. Use muapi auth configure first if MUAPI_API_KEY is unset.
• For model IDs without a CLI alias yet, fall back to the raw endpoint via curl -X POST https://api.muapi.ai/api/v1/<endpoint> -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}' and poll with muapi predict wait <request_id>.
• Substitute {{input_name}} placeholders with the user's actual inputs before issuing each call.