Skip to content

ByteDance · fal.ai · Reference images and audio to video

Seedance 2.5

Seedance 2.5 (ByteDance), reference images and audio to video, served by fal.ai. The OpenAPI schema for the bytedance/seedance-2.5/reference-to-video queue. Price: $0.0214 per 1,000 tokens at 480p and 720p, $0.0234 at 1080p (about $0.22, $0.47 and $1.16 per second of video; video references count 0.6x), metered by fal after the call (x-fal-billable-units) and billed at that reading; the reservation is the per-second bound for the duration and resolution asked and the difference is refunded. Asynchronous: returns a request_id; poll fal/status and fetch fal/result with model "bytedance/seedance-2.5".

Usage based fal.aiVideofal/seedance-2-5-reference-to-videoListed

Activation pending; your agent will see it as unavailable until then.

Use this tool with your agent

Give this to your agent
Use my connected Agentik MCP server. I want to use the tool fal/seedance-2-5-reference-to-video (Seedance 2.5 (ByteDance), reference images and audio to video). Call inspect_tool with {"tool_id": "fal/seedance-2-5-reference-to-video"} first and tell me the price before anything runs. Ask me for the inputs it needs; never invent values, IDs or file URLs. When I confirm, call run_tool with tool_id "fal/seedance-2-5-reference-to-video" and my inputs, follow it with get_run if it is still running, and give me the result and the price Agentik reports. If the tool is unavailable, say so and use discover_tools to propose an alternative.
Show the prompt

Paste it into Claude, ChatGPT or Codex: your agent takes it from there, and shows the price before it runs.

Parameters

NameTypeRequiredDescription
audio_urlsstring[]NoReference audio to guide video generation. Refer to them in the prompt as @Audio1, @Audio2, etc. Supported formats: MP3, WAV. Up to 10 files. Each file must be 1.8 to 30.2 seconds and no larger than 15 MB; combined duration must not exceed 30.2 seconds. At least one reference image or video is required.
durationstringNoDuration of the video in seconds. Supports 4 to 30 seconds, or auto to let the model decide based on the prompt. Options: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.
promptstringYesThe text prompt used to generate the video.
end_user_idstringNoThe unique user ID of the end user.
aspect_ratiostringNoThe 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. Options: auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
video_urlsstring[]NoReference videos to guide video generation. Refer to them in the prompt as @Video1, @Video2, etc. Supported formats: MP4, MOV. Up to 10 videos. Each video must be 1.8 to 30.2 seconds and no larger than 200 MB; combined duration must not exceed 30.2 seconds. Dimensions must be 300 to 6,000 pixels per side, aspect ratio 0.4 to 2.5, and frame rate 24 to 60 FPS.
bitrate_modestringNoOutput bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate. Options: standard, high.
generate_audiobooleanNoWhether 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.
resolutionstringNoVideo resolution - 480p for faster generation, 720p for balance, 1080p for high quality. Options: 480p, 720p, 1080p.
image_urlsstring[]NoReference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF. Max 30 MB per image. Up to 30 images. Total files across all modalities must not exceed 50.

How your agent calls it

First inspect_tool for the current schema and price, then run_tool with the published example after confirming your inputs:

{
  "tool_id": "fal/seedance-2-5-reference-to-video",
  "input": {
    "prompt": "a red cube slowly rotating on a white table, soft studio light",
    "image_urls": [
      "https://storage.googleapis.com/falserverless/example_outputs/nano-banana-2-t2i-output.png"
    ],
    "resolution": "480p",
    "duration": "4",
    "generate_audio": false
  }
}

Price and billing

Price
Usage based
Model
Per unit
Detail
The provider’s price, with no markup. Billed for measured usage.
  • The provider’s price, 0% markup.
  • One prepaid balance for every provider; your agent sees the price before it runs.
  • Pay for measured usage; unused reservations are released.