Spiral gives your agent every tool with one account. Browse the tools →

Windsurf · VideoReleased 2026-10-16

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.

Kling 4.0 Reference to VideoWindsurf
Try asking
  • 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

  1. 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"
        }
      }
    }
  2. 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
  3. Check it

    Spiral is listed under This computer in Customize › MCPs. From the terminal:

    devin mcp list

Use the Spiral skill

  1. Send Windsurf this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. 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

  1. Create an API key

    In the console, under API keys.

  2. 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.

falVideo
Kling 4.0 Reference to Video
kling/v4/reference-to-video

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.

SettingAllowed valuesDefaultDescription
Duration3 to 305

Video duration in seconds (3-30).

Resolution720p or 1080p1080p

Output resolution.

Aspect ratioauto, 16:9, 9:16, 1:1, or 21:916: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.

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.

Get started

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 Windsurf

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options