scrollport

Back to Generate videos

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
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_ratiostring · optional

Value supplied for aspect ratio.

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

durationinteger · optional

Value supplied for duration.

image_urlsarray · optional

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

maxItems: 9

max_reference_video_secondsnumber · 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

promptstring · 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

resolutionstring · optional

Value supplied for resolution.

enum: 480p, 720p, 1080p

video_urlsarray · 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_typestring

Returned content type value.

duration_secondsnumber

Returned duration seconds value.

modelstring

Returned model value.

reference_video_secondsnumber

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.
Seedance 2.5 Motion Reference: price, inputs and example | Scrollport