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

Claude Code · VideoReleased 2026-07-31

How to Use Seedance 2.5 US Reference to Video in Claude Code

Seedance 2.5 Reference to Video uses images, video, and audio to guide a new clip, edit footage, or continue a scene. Unlike Seedance 2.5 Image to Video, it can draw on several assets for appearance, movement, and sound.

Prompts to try with Seedance 2.5 US Reference to Video in Claude Code

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

Use Seedance 2.5 Reference to Video with the project's approved character and setting images to create a 12-second scene. The character enters the workshop, finds a broken stool, and begins repairing it; assign each reference its role.

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

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

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

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

How to set up Seedance 2.5 US Reference to Video in Claude Code

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

Use Spiral's MCP server

  1. Add the hosted server

    This adds Spiral to the current project. Add --scope user to use it in every project.

    claude mcp add --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

Use the Spiral skill

  1. Send Claude Code 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 Seedance 2.5 US 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": "bytedance/seedance-2.5/us/reference-to-video",
        "input": {
          "prompt": "An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea."
        }
      }'

Then paste one of the prompts above: Claude Code finds Seedance 2.5 US Reference to Video on Spiral, shows the price and runs it.

Seedance 2.5 US Reference to Video providers and prices

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

falVideo
Seedance 2.5 US Reference to Video
bytedance/seedance-2.5/us/reference-to-video

Settings you can ask for

Seedance 2.5 US Reference to Video works from your prompt, image URLs, video URLs, and audio URLs. Ask Claude Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Taskauto, reference, editing, or extensionreference

The type of video generation task. Reference uses the supplied media as guidance. Editing modifies a reference video and automatically coerces aspect_ratio and duration to auto. Extension continues a reference video and automatically coerces aspect_ratio to auto. Auto leaves the task type unset so the model decides it from the prompt and references.

Resolution480p, 720p, or 1080p720p

Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality.

Durationauto, 4, 5, 6, 7, 8, 9, 10 and 20 moreauto

Duration of the video in seconds. Supports 4 to 30 seconds, or auto to let the model decide based on the prompt.

Aspect ratioauto, 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16auto

The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to let the model decide.

Generate audioon or offon

Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not.

Bitrate modestandard or highstandard

Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate.

Codecauto, H264, or H265auto

'auto' retains default video codec behaviour; 'H264' uses H.264; 'H265' uses H.265.

Seeda whole number

Random seed for reproducibility. Note that results may still vary slightly even with the same seed.

Every API field of Seedance 2.5 US Reference to Video is on its tool page: open its card above.

What can you do with Seedance 2.5 US Reference to Video in Claude Code?

Create short video assets alongside the project that will use them. Your coding agent can turn a creative brief into scene directions covering action, camera movement, and sound.

Short narrative ads

Build a 20-second scene around a problem, a useful action, and a clear result. Develop the scene from writing, an opening still, or supplied references with the corresponding Seedance 2.5 model.

Atmospheric footage

Create short location shots for an introduction or transition, with deliberate camera movement and matching ambience. Describe a setting or supply visual material to establish its appearance.

Dialogue scene drafts

Test a brief exchange with spoken lines, pauses, gestures, and camera direction. Review the delivery and synchronization before using the clip.

Camera treatment comparisons

Explore how a scene feels with a slow push, a tracking shot, or a locked camera. Keep the action and sound description consistent while changing the camera direction.

Product stills with motion

Turn a supplied product image into a short presentation with a camera move, environmental motion, and sound. Check labels and fine details against the original image.

Illustrated scene animation

Give an existing illustration a small sequence of actions, such as a character opening a door while the camera follows. Use the supplied art to establish the scene's appearance.

Targeted footage edits

Ask Seedance 2.5 Reference to Video to change a specified visual element in supplied footage. Describe both the change and the details that should stay consistent.

Scene continuations

Continue a supplied clip with the next action in the story. Specify how the subject, environment, camera, and sound should carry into the new footage.

Questions about Seedance 2.5 US Reference to Video in Claude Code

Can Claude Code use Seedance 2.5 US Reference to Video?

Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Seedance 2.5 US Reference to Video like any built-in tool.

How much does Seedance 2.5 US Reference to Video cost in Claude Code?

Up to $18.44466 per run at the default inputs. `resolution`: 480p $8.59638, 720p (default) $18.44466, 1080p $45.392724. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.

Do I need a fal account to use Seedance 2.5 US Reference to Video in Claude Code?

No. Spiral runs Seedance 2.5 US 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 Seedance 2.5 US Reference to Video in Claude Code?

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

Does Claude Code wait while Seedance 2.5 US Reference to Video runs?

Seedance 2.5 US Reference to Video runs in the background. Claude Code starts the run, checks on it and gives you the video when it's ready.

How long can a Seedance 2.5 video be?

A single generation can last 4 to 30 seconds. That gives a short story room for a setup, an action, and a resolution.

Does Seedance 2.5 generate sound with the video?

Yes. It can generate sound effects, ambience, and spoken dialogue alongside the picture. Describe the sounds you want as part of the scene.

Which languages does Seedance 2.5 support?

BytePlus documents prompt input and generated speech in Chinese, English, Spanish, Indonesian, Malay, Thai, Arabic, Portuguese, Vietnamese, Japanese, and Korean. State the spoken language explicitly when writing dialogue.

What resolution can Seedance 2.5 produce?

The models listed here support 480p, 720p, and 1080p. Specify the intended resolution when requesting a clip.

How should I write a Seedance 2.5 prompt?

Describe the subject, what happens, the setting, the visual style, the camera movement, and the sound. For a short narrative, give the action a clear beginning and ending.

Get started

Start using Seedance 2.5 US Reference to Video in Claude Code

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

Paste this into Claude Code:

Set up Claude Code

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