How to Use Seedance 2.5 US Reference to Video in opencode
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 opencode
Copy an example into opencode, 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.
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 opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- Sign in
Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode 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 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: opencode 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.
Up to $18.44466 per run at the default inputs. resolution: 480p $8.59638, 720p (default) $18.44466, 1080p $45.392724.
Settings you can ask for
Seedance 2.5 US Reference to Video works from your prompt, image URLs, video URLs, and audio URLs. Ask opencode for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Task | auto, reference, editing, or extension | reference | 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. |
| Resolution | 480p, 720p, or 1080p | 720p | Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality. |
| Duration | auto, 4, 5, 6, 7, 8, 9, 10 and 20 more | auto | Duration of the video in seconds. Supports 4 to 30 seconds, or auto to let the model decide based on the prompt. |
| Aspect ratio | auto, 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16 | auto | 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 audio | on or off | on | 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 mode | standard or high | standard | Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate. |
| Codec | auto, H264, or H265 | auto | 'auto' retains default video codec behaviour; 'H264' uses H.264; 'H265' uses H.265. |
| Seed | a 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 opencode?
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.
More on Seedance 2.5 US Reference to Video and opencode
Overview
Seedance 2.5 US Reference to Video in other agents
Questions about Seedance 2.5 US Reference to Video in opencode
Can opencode use Seedance 2.5 US Reference to Video?
Yes. Add Spiral to opencode as an MCP server, and opencode 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 opencode?
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 opencode plan is separate.
Do I need a fal account to use Seedance 2.5 US Reference to Video in opencode?
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 opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while Seedance 2.5 US Reference to Video runs?
Seedance 2.5 US Reference to Video runs in the background. opencode 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.
Start using Seedance 2.5 US Reference to Video in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


