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

Cursor · Video

How to Use Grok Imagine Reference to Video in Cursor

Create a new scene guided by up to seven reference images. Unlike Grok Imagine Image to Video, it does not lock the opening frame, so you can place referenced characters or products into a different composition.

Prompts to try with Grok Imagine Reference to Video in Cursor

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

Use Grok Imagine Reference to Video with the character portrait and environment artwork in this project. Create an eight-second, 720p scene in which the character walks through the environment while the camera slowly pans right.

Grok Imagine Reference to VideoCursor
Try asking
  • Estimate, then generate a 5-second 9:16 clip with Grok Imagine Reference to Video: a paper boat drifting down a rainy street. Save the result in ./assets.

  • Make a 10-second product teaser with Grok Imagine Reference to Video for a smartwatch, slow orbit shot, studio lighting.

  • Generate three 5-second b-roll clips of a busy coffee shop with Grok Imagine Reference to Video and list what each cost.

  • Make a 6-second 16:9 drone shot over a misty pine forest at sunrise with Grok Imagine Reference to Video.

How to set up Grok Imagine Reference to Video 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 Grok Imagine 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": "xai/grok-imagine-video/reference-to-video",
        "input": {
          "prompt": "A @Image1 running through a sunlit meadow, cinematic slow motion",
          "reference_image_urls": [
            "<reference_image_urls>"
          ]
        }
      }'

Then paste one of the prompts above: Cursor finds Grok Imagine Reference to Video on Spiral, shows the price and runs it.

Grok Imagine Reference to Video providers and prices

Spiral runs Grok Imagine Reference to Video through fal. Open a card for today's price, with every fee included.

falVideo
Grok Imagine Reference to Video
xai/grok-imagine-video/reference-to-video

Settings you can ask for

Grok Imagine Reference to Video works from your prompt and reference image URLs. Ask Cursor for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Duration1 to 108

Video duration in seconds.

Resolution480p or 720p480p

Resolution of the output video.

Aspect ratio16:9, 4:3, 3:2, 1:1, 2:3, 3:4, or 9:1616:9

Aspect ratio of the generated video.

Every API field of Grok Imagine Reference to Video is on its tool page: open its card above.

What can you do with Grok Imagine Reference to Video in Cursor?

Create short video assets for a website, game prototype, or product presentation while working in your project. Have the coding agent turn the creative brief into a concrete shot description with camera movement and sound.

Product shot concepts

Test a short product scene with a slow camera move, deliberate lighting, and a simple sound direction. Start from a written concept, a finished product still, or product reference images as appropriate.

Storyboard motion studies

Turn a planned story beat into a six-second shot to assess framing and movement before production. Use text, an opening illustration, or character references according to the chosen model.

Social video concepts

Explore a short scene composed for a phone screen, with one action and an explicit sound direction. Prepare portrait imagery when starting from a still or visual references.

Camera movement comparisons

Generate separate versions of a scene with a slow zoom, pan, or dolly movement. Compare how each movement changes the emphasis before choosing a shot direction.

Atmospheric cutaway footage

Create brief scene-setting shots such as curtains moving beside a window or rain falling on an empty street. Pair the visible movement with matching ambient sound.

Place a referenced product in a new scene

Use product and setting images to guide a new composition without fixing the first frame. Keep the requested action simple enough to fit within ten seconds.

Questions about Grok Imagine Reference to Video in Cursor

Can Cursor use Grok Imagine Reference to Video?

Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run Grok Imagine Reference to Video like any built-in tool.

How much does Grok Imagine Reference to Video cost in Cursor?

`resolution`: 480p (default) $0.065, 720p $0.091 per second. Billed on `duration`, default 8. 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 Grok Imagine Reference to Video in Cursor?

No. Spiral runs Grok Imagine 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 Grok Imagine Reference to Video in Cursor?

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

Does Cursor wait while Grok Imagine Reference to Video runs?

Grok Imagine Reference to Video runs in the background. Cursor starts the run, checks on it and gives you the video when it's ready.

What is Grok Imagine Video useful for?

Use it to explore short visual ideas such as product shots, story scenes, camera movements, and animated illustrations. Describe what moves and what the viewer should hear so the result has a clear purpose.

Does Grok Imagine Video generate sound?

Yes, Grok Imagine Video generates audio alongside the picture. Include the sounds you want in the scene description instead of leaving the sound direction unspecified.

Can Grok Imagine Video produce 1080p or 4K?

The original Grok Imagine Video models listed here stop at 720p. They are a poor fit when your deliverable requires native 1080p or 4K footage.

How long can a Grok Imagine Video clip be?

Text to Video and Image to Video support 1 to 15 seconds. Reference to Video supports 1 to 10 seconds, so plan longer sequences as separate shots.

What should I put in a Grok Imagine Video prompt?

Describe the subject, its action, the camera movement, lighting, and sound. Replace phrases such as 'make it cinematic' with visible directions such as 'the camera slowly moves toward the cup as steam rises.'

Get started

Start using Grok Imagine Reference to Video 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