How to Use Kling 4.0 Reference to Video in Windsurf
Kling 4.0 Reference to Video combines image or video references with shot-by-shot direction for scenes up to 30 seconds. Compared with Kling 4.0 Flash Reference to Video, it offers longer output and 1080p.
Prompts to try with Kling 4.0 Reference to Video in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use the project's character and location images with Kling 4.0 Reference to Video to create a 10-second 1080p scene. Assign each image a clear role and show the character walking toward the doorway.
Estimate, then generate a 5-second 9:16 clip with Kling 4.0 Reference to Video: a paper boat drifting down a rainy street. Save the result in ./assets.
Make a 10-second product teaser with Kling 4.0 Reference to Video for a smartwatch, slow orbit shot, studio lighting.
Generate three 5-second b-roll clips of a busy coffee shop with Kling 4.0 Reference to Video and list what each cost.
Make a 6-second 16:9 drone shot over a misty pine forest at sunrise with Kling 4.0 Reference to Video.
How to set up Kling 4.0 Reference to Video in Windsurf
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: ~/.config/devin/mcp_config.json on macOS and Linux, %APPDATA%\devin\mcp_config.json on Windows. Add this:
{ "mcpServers": { "spiral": { "url": "https://api.spiral.ai/mcp" } } } - Sign in
Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.
devin mcp login spiral
- Check it
Spiral is listed under This computer in Customize › MCPs. From the terminal:
devin mcp list
Use the Spiral skill
- Send Windsurf this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Kling 4.0 Reference to Video
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "fal", "model": "kling/v4/reference-to-video", "input": { "prompt": "@Element1 and @Element2 are having dinner at the table in @Image1" } }'
Then paste one of the prompts above: Windsurf finds Kling 4.0 Reference to Video on Spiral, shows the price and runs it.
Kling 4.0 Reference to Video providers and prices
Spiral runs Kling 4.0 Reference to Video through fal. Open a card for today's price, with every fee included.
$0.306 per second at 1080p ($0.204 at 720p). With reference videos: $0.183 per second of reference plus output at 1080p ($0.122 at 720p), at least twice the output's length.
Settings you can ask for
Kling 4.0 Reference to Video works from your prompt, start image URL, image URLs, and video URLs. Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Duration | 3 to 30 | 5 | Video duration in seconds (3-30). |
| Resolution | 720p or 1080p | 1080p | Output resolution. |
| Aspect ratio | auto, 16:9, 9:16, 1:1, or 21:9 | 16:9 | Aspect ratio of the generated video. 'auto' adapts it to the references. |
Every API field of Kling 4.0 Reference to Video is on its tool page: open its card above.
What can you do with Kling 4.0 Reference to Video in Windsurf?
Turn a project's creative brief into short video assets and controlled shot tests. Use project files to keep the subject, visual direction, and review criteria consistent.
Product shot tests
Create or revise a short product shot to compare lighting, camera movement, and presentation before choosing a direction.
Social video hooks
Develop short opening shots with a clear visual action, then compare different ways to introduce a product or character.
Film previsualization
Create or revise a scene to test character blocking, camera coverage, and the timing of a visible action before a shoot.
Visual style studies
Explore a short scene through specific materials, lighting, and color choices, using a written brief or suitable source assets.
Animate a product image
Start with a product image and request a slow camera move that reveals its shape, surface, or packaging.
Recreate a camera concept
Use reference footage to guide a new scene's camera movement and pacing, with separate references for the intended product or character.
More on Kling 4.0 Reference to Video and Windsurf
Overview
Kling 4.0 Reference to Video in other agents
Questions about Kling 4.0 Reference to Video in Windsurf
Can Windsurf use Kling 4.0 Reference to Video?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Kling 4.0 Reference to Video like any built-in tool.
How much does Kling 4.0 Reference to Video cost in Windsurf?
$0.306 per second at 1080p ($0.204 at 720p). With reference videos: $0.183 per second of reference plus output at 1080p ($0.122 at 720p), at least twice the output's length. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.
Do I need a fal account to use Kling 4.0 Reference to Video in Windsurf?
No. Spiral runs Kling 4.0 Reference to Video on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Kling 4.0 Reference to Video in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Kling 4.0 Reference to Video runs?
Kling 4.0 Reference to Video runs in the background. Windsurf starts the run, checks on it and gives you the video when it's ready.
What should I include in a Kling 4.0 prompt?
Describe the subject, visible action, setting, lighting, and camera movement. Give concrete details, such as a bottle catching side light, instead of asking for a premium look.
Should I use long negative prompts?
Keep them brief. Kling recommends describing what should appear and warns that negative prompts can increase errors.
How do I describe a visual style clearly?
Translate the style into visible details. For a vintage room, describe worn furniture, yellowed walls, and warm incandescent light.
How can I reduce ambiguity in an action prompt?
Describe the pose and movement you want to see. For example, ask for a person shown in profile during a phone call instead of listing views to avoid.
What should I change when a result misses the brief?
Replace vague instructions with observable details about the missed action, framing, or lighting. Revise one part of the brief at a time so you can judge the effect.
Start using Kling 4.0 Reference to Video in Windsurf
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Windsurf:
set up https://spiral.ai/SKILL.md


