fal-seedance

Generate Seedance and Kling videos from image references via the fal.ai API.

25|1|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/wisdom-in-a-nutshell/agents --skill fal-seedance-wisdom-in-a-nutshell
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fal-seedance
Source: https://github.com/wisdom-in-a-nutshell/agents/tree/main/skills-source/owned/fal-seedance
Command: npx skills add https://github.com/wisdom-in-a-nutshell/agents --skill fal-seedance-wisdom-in-a-nutshell

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires fal-client, and includes scripts (resource) and references (resource) components.

What problem does it solve? Turning storyboard frames and reference images into short AI-generated video clips through fal.ai requires careful handling of uploads, endpoint selection, prompt conventions, and output tracking. This Skill wraps that entire workflow in a single CLI so agents can run Seedance 2.0 reference-to-video and image-to-video generations with dry-run validation, local file uploads, MP4 downloads, and JSON receipts. ## Core Features & Use Cases - Reference-to-video (ref2v): Animate up to 9 image references on Seedance 2.0 full or fast endpoints, with @ImageN prompt handles, 480p-1080p resolution, and multi-action timed-segment prompts. - Image-to-video (i2v): Deterministic start-to-end frame morphs across Seedance and Kling O3/V3 endpoints, with automatic parameter stripping for Kling. - Safe iteration workflow: Dry-run every prompt before spending credits, verify credentials with validate and doctor --remote, and keep a JSON receipt next to every downloaded MP4 for reproducibility. - Use Case: Animate a storyboard frame into a 4-second portrait canary using two extra identity/style anchor images, then compare receipts across runs to measure drift. ## Quick Start Ask the agent to dry-run a Seedance canary that animates your storyboard frame with a restrained motion prompt, then remove the dry-run flag to render the MP4 into your project folder.

Frequently Asked Questions about fal-seedance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a video from reference images with fal.ai Seedance?▼

Run the CLI's run subcommand with repeated --ref flags for local images and a prompt that references them as @Image1, @Image2, and so on. Start with --dry-run to validate inputs, then remove it to upload files, submit the job, and download the MP4.

What is the difference between Seedance reference-to-video and image-to-video?▼

Reference-to-video animates a primary frame using up to 9 images as identity, style, or environment anchors. Image-to-video performs a deterministic morph between a start frame and an end frame, and supports both Seedance and Kling O3/V3 endpoints.

When should I use Kling endpoints instead of Seedance?▼

Switch to Kling O3 or V3 image-to-video endpoints when Seedance output shows chroma noise on smooth or cream backgrounds. Note that Kling endpoints do not accept resolution or generate-audio parameters, and the CLI strips them automatically.

Does the fal Seedance CLI support 1080p video generation?▼

Yes, 1080p is the default resolution on the full Seedance endpoints. The fast endpoints cap at 720p, so use them only for cheap prompt iteration and switch to the full endpoint for production renders.

Why does my fal.ai request fail with a billing or auth error?▼

An E_BILLING_REQUIRED error means the fal account balance is exhausted and must be topped up before generation. Auth errors indicate the FAL_KEY in ~/.secrets/fal/env is missing or rejected; refresh it with the machine-secret materializer and verify with doctor --remote.

How do I keep character identity consistent across Seedance generations?▼

Pass extra reference images and explicitly assign each a role in the prompt, such as identity anchor or style anchor. State constraints like no face reshaping, no outfit change, and locked camera, and keep each run's JSON receipt to compare drift.