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

Cursor · VideoReleased 2025-01-10

How to Use Hailuo S2V-01 in Cursor

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 Cursor

Copy an example into Cursor, 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.

Hailuo S2V-01Cursor
Try asking
  • 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 Cursor

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the hosted server

    Use Add to Cursor on the console's Agents & MCP page, or add this to .cursor/mcp.json (one project) or ~/.cursor/mcp.json (every project):

    {
      "mcpServers": {
        "spiral": { "url": "https://api.spiral.ai/mcp" }
      }
    }
  2. Sign in

    Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

Use the Spiral skill

  1. Send Cursor 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 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: Cursor 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.

falVideo

Settings you can ask for

Hailuo S2V-01 works from your prompt. Ask Cursor for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Prompt optimizeron or offon

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 Cursor?

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.

Questions about Hailuo S2V-01 in Cursor

Can Cursor use Hailuo S2V-01?

Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run Hailuo S2V-01 like any built-in tool.

How much does Hailuo S2V-01 cost in Cursor?

$0.65 per video. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Cursor plan is separate.

Do I need a fal account to use Hailuo S2V-01 in Cursor?

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 Cursor?

About two minutes: add the hosted server, then sign in.

Does Cursor wait while Hailuo S2V-01 runs?

Hailuo S2V-01 runs in the background. Cursor 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.

Get started

Start using Hailuo S2V-01 in Cursor

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Cursor:

Set up Cursor

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