How to Use Hailuo S2V-01 in Windsurf
Hailuo S2V-01 creates six-second, 720p scenes using a person's photo as an identity reference. Choose it for keeping a face recognizable while changing the setting, expression, or lighting.
Prompts to try with Hailuo S2V-01 in Windsurf
Copy an example into Windsurf, or ask in your own words.
Use Hailuo S2V-01 with the reference portrait in this project's assets to create a six-second, 720p scene: the person stands beside a cafe window, looks outside, and smiles slightly. Use soft morning light and save the take with the scene assets.
Read the project's storyboard and use Hailuo S2V-01 to create a six-second, 720p preview of the lead character's arrival. Use the existing reference portrait, choose one action from the storyboard, and keep the prompt under 2,000 characters.
Use Hailuo S2V-01 and the project's reference portrait to make three six-second lighting studies. Keep the person seated with a neutral expression; change only the light between overcast daylight, side window light, and a warm desk lamp.
Use Hailuo S2V-01 with the project's character portrait to create a six-second reaction insert: the person looks up from a table and raises their eyebrows slightly. Set prompt_optimizer to false and save the exact prompt beside the output.
Use Hailuo S2V-01 to create two six-second wardrobe previews from the project's reference portrait. Keep the person standing in the same plain studio setting, and change only the jacket from dark denim to a tan coat.
How to set up Hailuo S2V-01 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 Hailuo S2V-01
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": "fal-ai/minimax/video-01-subject-reference", "input": { "prompt": "A stylish woman walks down a Tokyo street filled with warm glowing neon and animated city signage.", "subject_reference_image_url": "https://fal.media/files/tiger/s2xnjhLpjM6L8ISxlDCAw.png" } }'
Then paste one of the prompts above: Windsurf finds Hailuo S2V-01 on Spiral, shows the price and runs it.
Hailuo S2V-01 providers and prices
Spiral runs Hailuo S2V-01 through fal. Open a card for today's price, with every fee included.
Settings you can ask for
Hailuo S2V-01 works from your prompt. Ask Windsurf for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Prompt optimizer | on or off | on | Whether to use the model's prompt optimizer |
Every API field of MiniMax (Hailuo AI) Video 01 Subject Reference · Image to Video is on its tool page: open its card above.
What can you do with Hailuo S2V-01 in Windsurf?
Create short character scenes for a project's video assets using a reference portrait. A coding agent can turn a shot list into prompts and organize takes for review.
Short-film scene previews
Use one person's reference photo to explore separate six-second shots of a lead character arriving, pausing, or reacting. Review facial continuity before assembling a sequence.
Casting and wardrobe mockups
Preview a person in a proposed setting and outfit before a shoot. Keep the pose and lighting consistent when comparing wardrobe ideas.
Recurring social-video characters
Reuse the same portrait for short scenes featuring a recurring character. Write each scene around one action, such as entering a cafe or looking toward the camera.
Lighting studies for portraits
Compare how a referenced person looks under window light, overcast daylight, and warm evening light. Keep the expression and setting fixed to make the comparison useful.
Reaction inserts for an edit
Generate brief reaction shots of the referenced person looking surprised, thoughtful, or pleased. Select takes that preserve the face and avoid distracting background changes.
Campaign concept previews
Place the same referenced person in several proposed campaign settings. Use the clips to discuss mood and scene direction before committing to production.
More on Hailuo S2V-01 and Windsurf
Overview
Hailuo S2V-01 in other agents
Questions about Hailuo S2V-01 in Windsurf
Can Windsurf use Hailuo S2V-01?
Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run Hailuo S2V-01 like any built-in tool.
How much does Hailuo S2V-01 cost in Windsurf?
$0.65 per video. 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 Hailuo S2V-01 in Windsurf?
No. Spiral runs Hailuo S2V-01 on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up Hailuo S2V-01 in Windsurf?
About two minutes: add the server, then sign in, then check it.
Does Windsurf wait while Hailuo S2V-01 runs?
Hailuo S2V-01 runs in the background. Windsurf starts the run, checks on it and gives you the video when it's ready.
What is Hailuo S2V-01 good at?
It is designed to keep a person's facial features recognizable in generated video. Consider it for short character scenes, casting previews, and recurring visual presenters.
Does the reference photo become the first frame?
The photo supplies the person's identity. Describe the setting, posture, expression, and lighting you want in the prompt rather than expecting the original composition to carry over.
How long are the videos, and what resolution do they use?
Hailuo S2V-01 produces six-second clips at 720p. Plan longer stories as separate shots for editing together afterward.
What are the main weaknesses?
MiniMax warns that prompt following can be less precise than with its T2V and I2V models, and backgrounds can morph. Review both the face and the surrounding scene before choosing a take.
How should I write a prompt?
Describe a specific shot: what the person does, where they are, their expression, and the lighting. As a starting approach, keep the action simple enough to fit six seconds; the documented prompt limit is 2,000 characters.
Start using Hailuo S2V-01 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


