# Seedance 2.5 Motion Reference

ByteDance

Generate video guided by a source clip, with optional character images.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Seedance 2.5 Motion Reference (tool ID: bytedance.seedance-2-5-motion-reference). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Generate videos](https://scrollport.com/tools/ai-video-generation-api)

**Current price:** $0.2310/video second

**Availability:** Ready to run

## Tool details

**About this tool**

Use a source video for motion and optional images for appearance. Upload files and use get_files URLs, or supply direct HTTPS downloads. Refer to @video1 for motion and @image1 for appearance. Supply one H.264/H.265 MP4 (2–30 seconds, 24–60 fps, up to 200 MB) and up to nine images. Each side must be 300–6000 px, aspect ratio 0.4–2.5, and total pixels 407,696–8,295,044; 720×720 at 24 fps works. Set max_reference_video_seconds to cover the source. Pay for requested output seconds at the chosen resolution, only on successful delivery. Source-video time is not billed separately. External sources are copied privately and expire within 24 hours; workspace files keep their retention. Portrait review is automatic and may reject references. Motion is guided, not guaranteed frame-exact transfer. Editing and extension are unsupported. Output is saved privately; no separate provider account is needed.

**Inputs and outputs**

### Input

`aspect_ratio` string · optional

Value supplied for aspect ratio.

enum: 16:9, 9:16, 4:3, 3:4, 21:9, 1:1, adaptive

`duration` integer · optional

Value supplied for duration.

`image_urls` array · optional

Optional character/appearance images accessible for 24 hours. Portrait review is automatic.

maxItems: 9

`max_reference_video_seconds` number · required

Upper bound on the allowed source duration. Scrollport measures the file (rounded up to 0.001 seconds) and rejects longer inputs before generation. This source-duration limit does not change the output-only price.

minimum: 2 · maximum: 30

`prompt` string · required

Assign motion to @video1 and optional character appearance to @image1 in at most 4,000 characters. Oversized prompts are rejected, not truncated. Request a new video, not editing or extension.

minLength: 1 · maxLength: 4000

`resolution` string · optional

Value supplied for resolution.

enum: 480p, 720p, 1080p

`video_urls` array · required

One direct HTTPS H.264/H.265 MP4, 2–30 seconds, 24–60 fps, at most 200 MB. Width/height: 300–6000 px; width/height ratio: 0.4–2.5; width × height: 407,696–8,295,044 pixels. Example: 720×720 at 24 fps. Use get_files for uploads. Live streams

minItems: 1 · maxItems: 1

### Output

`content_type` string

Returned content type value.

`duration_seconds` number

Returned duration seconds value.

`model` string

Returned model value.

`reference_video_seconds` number

Returned reference video seconds value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "bytedance.seedance-2-5-motion-reference",
  "input": {
    "prompt": "Use the left-to-right camera movement in @video1 as a motion reference. Generate a new shot of a jade cube on a white tiled surface with the same camera rhythm. Keep the subject and setting simple.",
    "duration": 5,
    "resolution": "480p",
    "video_urls": [
      "https://scrollport.com/examples/seedance-motion-reference.mp4"
    ],
    "aspect_ratio": "1:1",
    "max_reference_video_seconds": 2
  }
}
```

### Output

```
{
  "model": "Seedance 2.5",
  "content_type": "video/mp4",
  "duration_seconds": 5,
  "reference_video_seconds": 2
}
```

**Errors and limitations**

- `invalid_input`: The motion-reference settings or source media are invalid.Use one H.264/H.265 MP4 meeting the video_urls geometry and frame-rate limits (for example, 720×720 at 24 fps), and a duration bound covering the whole source. Inspect for accepted fields. No generation starts if measurement fails or the limit is exceeded.
- `upstream_error`: The video could not be delivered. Your wallet was not charged.References must pass provider review. Contact Scrollport support with the run ID; do not resubmit an unresolved run.

---

Canonical page: https://scrollport.com/tools/providers/bytedance/seedance-2-5-motion-reference