# Seedance 2.5 US reference to video

Takes image urls, codec, prompt and more, all optional. Served by fal.ai.

Seedance 2.5 US Reference to Video, served by fal.ai. The OpenAPI schema for the bytedance/seedance-2.5/us/reference-to-video queue. Price: For every second of 720p video you generate, you will be charged roughly $0.5676/second, and for 480p you will be charged $0.2646/second, and for every second of 1080p video, you will be charged roughly 1.396278 per second. Your request will cost $0.02568 per 1000 tokens for 480p and 720p, and $0.02808 per 1000 tokens for 1080p. The number of tokens is given by (height of output video * width of output video * (input video duration + output video duration) * 24) / 1024. If video inputs are provided the price is multiplied by 0.6. With video inputs and 720p resolution, the price is roughly $0.34056 per second. Reservation uses the validated Seedance 2.5 geometry/duration/reference bounds at 1.2x the global token rates; the exact request receipt is billed. Queued execution; final USD charge comes from the unique billing event matching this exact endpoint and request_id. A missing receipt retains the reservation; no guessed final fee. Asynchronous: returns a request_id; poll fal/status and fetch fal/result with model "bytedance/seedance-2.5" and that request_id. Billed once, when the result is ready; a generation that fails is refunded.

- Tool ID: `fal/bytedance-seedance-2-5-us-reference-to-video`
- Name in the catalog: Seedance 2.5 US Reference to Video
- Provider: [fal.ai](/providers/fal.md)
- Capability: [Seedance](/tools/video-generation/seedance.md)
- Price: usage based, the maximum is shown before a run
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_unit",
  "amountUsd": 0.5676,
  "unitsField": "duration",
  "unitsDefault": 5,
  "maxUnits": 30,
  "multipliers": [
    {
      "all": [
        {
          "field": "resolution",
          "equals": "480p"
        },
        {
          "field": "aspect_ratio",
          "equals": "21:9"
        }
      ],
      "setUsd": 0.34548
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "480p"
        },
        {
          "field": "aspect_ratio",
          "equals": "16:9"
        }
      ],
      "setUsd": 0.2634
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "480p"
        },
        {
          "field": "aspect_ratio",
          "equals": "4:3"
        }
      ],
      "setUsd": 0.1974
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "480p"
        },
        {
          "field": "aspect_ratio",
          "equals": "1:1"
        }
      ],
      "setUsd": 0.14808
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "480p"
        },
        {
          "field": "aspect_ratio",
          "equals": "3:4"
        }
      ],
      "setUsd": 0.11112
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "480p"
        },
        {
          "field": "aspect_ratio",
          "equals": "9:16"
        }
      ],
      "setUsd": 0.0834
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "480p"
        },
        {
          "field": "aspect_ratio",
          "equals": "auto"
        }
      ],
      "setUsd": 0.34548
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "720p"
        },
        {
          "field": "aspect_ratio",
          "equals": "21:9"
        }
      ],
      "setUsd": 0.72804
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "720p"
        },
        {
          "field": "aspect_ratio",
          "equals": "16:9"
        }
      ],
      "setUsd": 0.55476
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "720p"
        },
        {
          "field": "aspect_ratio",
          "equals": "4:3"
        }
      ],
      "setUsd": 0.41604
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "720p"
        },
        {
          "field": "aspect_ratio",
          "equals": "1:1"
        }
      ],
      "setUsd": 0.31212
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "720p"
        },
        {
          "field": "aspect_ratio",
          "equals": "3:4"
        }
      ],
      "setUsd": 0.23412
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "720p"
        },
        {
          "field": "aspect_ratio",
          "equals": "9:16"
        }
      ],
      "setUsd": 0.17556
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "720p"
        },
        {
          "field": "aspect_ratio",
          "equals": "auto"
        }
      ],
      "setUsd": 0.72804
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "1080p"
        },
        {
          "field": "aspect_ratio",
          "equals": "21:9"
        }
      ],
      "setUsd": 1.79124
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "1080p"
        },
        {
          "field": "aspect_ratio",
          "equals": "16:9"
        }
      ],
      "setUsd": 1.36476
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "1080p"
        },
        {
          "field": "aspect_ratio",
          "equals": "4:3"
        }
      ],
      "setUsd": 1.0236
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "1080p"
        },
        {
          "field": "aspect_ratio",
          "equals": "1:1"
        }
      ],
      "setUsd": 0.76764
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "1080p"
        },
        {
          "field": "aspect_ratio",
          "equals": "3:4"
        }
      ],
      "setUsd": 0.57576
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "1080p"
        },
        {
          "field": "aspect_ratio",
          "equals": "9:16"
        }
      ],
      "setUsd": 0.43224
    },
    {
      "all": [
        {
          "field": "resolution",
          "equals": "1080p"
        },
        {
          "field": "aspect_ratio",
          "equals": "auto"
        }
      ],
      "setUsd": 1.79124
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "4"
        }
      ],
      "factor": 5.13
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "5"
        }
      ],
      "factor": 4.224
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "6"
        }
      ],
      "factor": 3.6201
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "7"
        }
      ],
      "factor": 3.1886
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "8"
        }
      ],
      "factor": 2.8651
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "9"
        }
      ],
      "factor": 2.6134
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "10"
        }
      ],
      "factor": 2.412
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "11"
        }
      ],
      "factor": 2.2473
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "12"
        }
      ],
      "factor": 2.11
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "13"
        }
      ],
      "factor": 1.9939
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "14"
        }
      ],
      "factor": 1.8943
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "15"
        }
      ],
      "factor": 1.808
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "16"
        }
      ],
      "factor": 1.7325
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "17"
        }
      ],
      "factor": 1.6659
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "18"
        }
      ],
      "factor": 1.6067
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "19"
        }
      ],
      "factor": 1.5537
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "20"
        }
      ],
      "factor": 1.506
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "21"
        }
      ],
      "factor": 1.4629
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "22"
        }
      ],
      "factor": 1.4237
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "23"
        }
      ],
      "factor": 1.3879
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "24"
        }
      ],
      "factor": 1.3551
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "25"
        }
      ],
      "factor": 1.3248
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "26"
        }
      ],
      "factor": 1.297
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "27"
        }
      ],
      "factor": 1.2712
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "28"
        }
      ],
      "factor": 1.2472
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "29"
        }
      ],
      "factor": 1.2249
    },
    {
      "all": [
        {
          "field": "video_urls",
          "minLength": 1
        },
        {
          "field": "duration",
          "equals": "30"
        }
      ],
      "factor": 1.204
    }
  ],
  "unitsHeader": "x-fal-billable-units",
  "fractional": true,
  "unitsHeaderUsd": 0.02568,
  "unitsHeaderRules": [
    {
      "when": {
        "field": "resolution",
        "equals": "1080p"
      },
      "setUsd": 0.02808
    }
  ]
}
```

Pricing source: [https://fal.ai/models/bytedance/seedance-2.5/us/reference-to-video](https://fal.ai/models/bytedance/seedance-2.5/us/reference-to-video). For every second of 720p video you generate, you will be charged roughly $0.5676/second, and for 480p you will be charged $0.2646/second, and for every second of 1080p video, you will be charged roughly 1.396278 per second. Your request will cost $0.02568 per 1000 tokens for 480p and 720p, and $0.02808 per 1000 tokens for 1080p. The number of tokens is given by (height of output video * width of output video * (input video duration + output video duration) * 24) / 1024. If video inputs are provided the price is multiplied by 0.6. With video inputs and 720p resolution, the price is roughly $0.34056 per second. Reservation uses the validated Seedance 2.5 geometry/duration/reference bounds at 1.2x the global token rates; the exact request receipt is billed. Queued execution; final USD charge comes from the unique billing event matching this exact endpoint and request_id. A missing receipt retains the reservation; no guessed final fee..

Price verification date: 2026-10-07.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "image_urls": {
      "description": "Reference 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.",
      "type": "array",
      "title": "Image Urls",
      "items": {
        "type": "string"
      }
    },
    "codec": {
      "description": "'auto' retains default video codec behaviour; 'H264' uses H.264; 'H265' uses H.265.",
      "default": "auto",
      "type": "string",
      "enum": [
        "auto",
        "H264",
        "H265"
      ],
      "title": "Codec"
    },
    "prompt": {
      "description": "The text prompt used to generate the video.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Prompt"
    },
    "video_urls": {
      "description": "Reference 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.",
      "type": "array",
      "title": "Video Urls",
      "items": {
        "type": "string",
        "_fal_ui_field": "video"
      }
    },
    "seed": {
      "description": "Random seed for reproducibility. Note that results may still vary slightly even with the same seed.",
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Seed"
    },
    "duration": {
      "description": "Duration of the video in seconds. Supports 4 to 30 seconds, or auto to let the model decide based on the prompt.",
      "type": "string",
      "title": "Duration",
      "enum": [
        "4",
        "5",
        "6",
        "7",
        "8",
        "9",
        "10",
        "11",
        "12",
        "13",
        "14",
        "15",
        "16",
        "17",
        "18",
        "19",
        "20",
        "21",
        "22",
        "23",
        "24",
        "25",
        "26",
        "27",
        "28",
        "29",
        "30"
      ],
      "default": "5"
    },
    "end_user_id": {
      "description": "The unique user ID of the end user.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "End User Id"
    },
    "aspect_ratio": {
      "description": "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.",
      "default": "auto",
      "type": "string",
      "enum": [
        "auto",
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "title": "Aspect Ratio"
    },
    "generate_audio": {
      "description": "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.",
      "default": true,
      "type": "boolean",
      "title": "Generate Audio"
    },
    "resolution": {
      "description": "Video resolution - 480p for faster generation, 720p for balance, 1080p for high quality.",
      "default": "720p",
      "type": "string",
      "title": "Resolution",
      "enum": [
        "480p",
        "720p",
        "1080p"
      ]
    },
    "bitrate_mode": {
      "description": "Output bitrate mode. 'high' requests a higher-quality, larger-file encode from the model; 'standard' uses the default bitrate.",
      "default": "standard",
      "type": "string",
      "enum": [
        "standard",
        "high"
      ],
      "title": "Bitrate Mode"
    },
    "audio_urls": {
      "description": "Reference 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.",
      "type": "array",
      "title": "Audio Urls",
      "items": {
        "type": "string",
        "_fal_ui_field": "audio"
      }
    }
  },
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "fal/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.",
    "image_urls": [
      "https://v3b.fal.media/files/b/0a8eba37/Cqg-4Uwzyz4DELfceT1CF_a17e588773ec45b1a9e6f100a787b80b.jpg"
    ],
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "auto",
    "generate_audio": true,
    "bitrate_mode": "standard",
    "codec": "auto"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

This tool uses deferred settlement. Follow its returned task/run instructions; preserve the existing reservation until the result is reconciled.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://fal.ai/models/bytedance/seedance-2.5/us/reference-to-video)

[REST inspection](https://api.agentik.cc/v1/tools/fal/bytedance-seedance-2-5-us-reference-to-video) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/fal/bytedance-seedance-2-5-us-reference-to-video) · [Agent index](/llms.txt)