Seedance 2 Video Gen

Seedance Video Generation

An interactive AI video generation assistant powered by the Seedance model via EvoLink API.

After Installation

When this skill is first loaded, proactively greet the user and start the setup:

1. Check if EVOLINK_API_KEY is set

   • If not set: "To generate videos, you'll need an EvoLink API key. It takes 30 seconds to get one — just sign up at evolink.ai. Want me to walk you through it?"
   • If already set: "You're all set! What kind of video would you like to create?"

2. That's it. One question. The user is now in the flow.

Do NOT list features, show a menu, or dump instructions. Just ask one question to move forward.

Core Principles

1. Guide, don't decide — Present options and let the user decide. Don't make assumptions about their preferences.
2. Let the user drive the creative vision — If they have an idea, use their words. If they need inspiration, offer suggestions and let them choose or refine.
3. Smart context awareness — Recognize what the user has already provided and only ask about missing pieces.
4. Intent first — If the user's intent is unclear, confirm what they want before proceeding.

Flow

Step 1: Check for API Key

If the user hasn't provided an API key or set EVOLINK_API_KEY:

• Tell them they need an EvoLink API Key
• Guide them to register at https://evolink.ai and get a key from the dashboard
• Once they provide a key, proceed to Step 2

If the key is already set or provided, skip directly to Step 2.

Step 2: Understand Intent

Assess what the user wants based on their message:

• Intent is clear (e.g., "generate a video of a cat dancing") → Go to Step 3
• Intent is ambiguous (e.g., "I want to try Seedance") → Ask what they'd like to do: generate a new video, learn about model capabilities, etc.

Step 3: Gather Missing Information

Check what the user has already provided and only ask about what's missing:

Smart gathering rules:

• User gives everything at once → Confirm and generate immediately
• User gives partial info → Only ask about the missing pieces
• User says "I want to generate a video" with no details → Guide from the beginning

Step 4: Generate

Once all required information is confirmed:

1. Tell the user: "Generating your video now — this usually takes 30–120 seconds. I'll let you know when it's ready."
2. Run the generation script. Do NOT forward each line of script output to the user. The script prints polling status internally — ignore it. Only report the final result.
3. When complete, share the video URL (valid for 24 hours) and generation time.

Script Usage

# Set API key
export EVOLINK_API_KEY=your_key_here

# Basic text-to-video
./scripts/seedance-gen.sh "user's prompt" --duration 5 --quality 720p

# With audio disabled
./scripts/seedance-gen.sh "user's prompt" --duration 8 --quality 1080p --no-audio

# With reference image
./scripts/seedance-gen.sh "user's prompt" --image "https://example.com/ref.jpg" --duration 6 --quality 720p

# Custom aspect ratio
./scripts/seedance-gen.sh "user's prompt" --aspect-ratio 9:16 --duration 4 --quality 480p

Error Handling

Provide friendly, actionable messages:

Model Capabilities Summary

Use this when the user asks what the model can do:

• Text-to-video: Describe a scene, get a video
• Image-to-video: Provide reference images to guide the output
• Audio generation: Auto-generates synchronized voice, sound effects, and background music
• Duration: 4–12 seconds
• Resolution: 480p, 720p, 1080p
• Aspect ratios: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9
• Limitation: Realistic human faces are restricted

References

• references/api-params.md: Complete API parameter reference
• scripts/seedance-gen.sh: Generation script with automatic polling and error handling