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

Gemini CLI · VideoReleased 2025-02-11

How to Use Hailuo I2V-01 Director in Gemini CLI

Hailuo I2V-01 Director animates a supplied opening image with directed camera movement. Unlike Hailuo T2V-01 Director, it lets you establish the starting composition before generating motion.

Prompts to try with Hailuo I2V-01 Director in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Use Hailuo I2V-01 Director with the product image in this project's assets as the opening frame. Create a six-second shot with [Push in], keeping the action to a hand reaching toward the product.

Hailuo I2V-01 DirectorGemini CLI
Try asking
  • Use Hailuo I2V-01 Director with our approved storyboard image. Generate two separate six-second takes, one with [Static shot] and one with [Pan left], and add both to the review page.

  • Animate the image I attach with Hailuo I2V-01 Director: slow push-in, leaves moving in the wind. Save the result in ./assets.

  • Turn this product photo into a 5-second rotating shot with Hailuo I2V-01 Director.

  • Bring this portrait to life with Hailuo I2V-01 Director: a subtle smile and a blink.

How to set up Hailuo I2V-01 Director in Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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 I2V-01 Director

    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-director/image-to-video",
        "input": {
          "prompt": "[Push in, Follow]A stylish woman walks down a Tokyo street filled with warm glowing neon and animated city signage. She wears a black leather jacket, a long red…",
          "image_url": "https://storage.googleapis.com/falserverless/model_tests/wan/dragon-warrior.jpg"
        }
      }'

Then paste one of the prompts above: Gemini CLI finds Hailuo I2V-01 Director on Spiral, shows the price and runs it.

Hailuo I2V-01 Director providers and prices

Spiral runs Hailuo I2V-01 Director through fal. Open a card for today's price, with every fee included.

falVideo

Settings you can ask for

Hailuo I2V-01 Director works from your prompt and image URL. Ask Gemini CLI 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 Director - Image to Video · I2V-01 Director (Camera Control) is on its tool page: open its card above.

What can you do with Hailuo I2V-01 Director in Gemini CLI?

Turn a project's creative brief into short camera-directed shots for a website mockup, trailer, or storyboard. Your coding agent can use project context to draft prompts and organize takes for review.

Preview a film shot

Test a push toward a character or a pull back that reveals the setting before planning a shoot. Keep each test to one short story beat.

Compare camera treatments

Generate separate takes of the same scene with a pan, a tracking shot, and a static camera. Review how each choice changes the emphasis.

Draft a product ad shot

Try a six-second close-up of a bottle, bag, or watch with a deliberate camera move. Use the result to discuss framing and pacing.

Create an establishing shot

Explore a street, landscape, or interior with a slow pan or reveal. Use the clip as a short introduction within a larger edit.

Plan a game trailer moment

Preview a character entering a scene or a camera revealing a location. Compare the shot with the trailer's intended mood before building the final sequence.

Prepare background footage for a website

Generate a short atmospheric shot for a page mockup, such as a quiet workshop or wind moving through trees. Review it in the layout before choosing final footage.

Animate an approved storyboard frame

Start with the approved image and test the character action and camera direction. This lets the review begin from a composition the team has already chosen.

Questions about Hailuo I2V-01 Director in Gemini CLI

Can Gemini CLI use Hailuo I2V-01 Director?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Hailuo I2V-01 Director like any built-in tool.

How much does Hailuo I2V-01 Director cost in Gemini CLI?

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

Do I need a fal account to use Hailuo I2V-01 Director in Gemini CLI?

No. Spiral runs Hailuo I2V-01 Director 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 I2V-01 Director in Gemini CLI?

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

Does Gemini CLI wait while Hailuo I2V-01 Director runs?

Hailuo I2V-01 Director runs in the background. Gemini CLI starts the run, checks on it and gives you the video when it's ready.

What is Hailuo 01 Director useful for?

Use it to test how a short shot should move: a camera pushing toward a subject, tracking an action, or revealing a scene. MiniMax designed the Director models to reduce random movement and improve control over camera direction.

How long are Hailuo 01 Director videos?

Clips run up to six seconds at 720p and 25 frames per second. Plan a longer sequence as separate shots that you edit together.

How should I describe camera movement?

Write the scene and add an explicit direction such as [Push in] or [Pan left]. Natural-language descriptions also work, but MiniMax says explicit commands produce more accurate results.

Can I combine camera movements?

Yes. Commands inside one bracket, such as [Pan left, Tilt up], happen simultaneously; keep combinations to three movements or fewer.

What limits should I plan around?

The six-second clip length and 720p output are the main production constraints. For a longer story, use short shots with a clear action in each.

Get started

Start using Hailuo I2V-01 Director in Gemini CLI

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

Paste this into Gemini CLI:

Set up Gemini CLI

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