# Seedance 2.5 Portrait-to-Video

ByteDance

Animate portrait references after automatic image review.

## 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 Portrait-to-Video (tool ID: bytedance.seedance-2-5-portrait). 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**

Generate a 5–30 second Seedance 2.5 video from 1–9 portrait or character references. Upload images to your workspace, obtain their HTTPS URLs with get_files, then reference them as @image1, @image2 and so on in the prompt. Images are sent to the video provider for automatic private asset review before generation; review can reject a reference. Source URLs must remain accessible for 24 hours. The reference image can determine the output aspect ratio. Audio may be generated. Pricing is per requested video second at the chosen resolution, charged only after verified video delivery. Your video is saved privately in the workspace. No separate provider account is needed.

**Inputs and outputs**

### Input

`aspect_ratio` string · optional

Requested ratio; reference dimensions can take precedence.

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

`duration` integer · optional

Value supplied for duration.

`image_urls` array · required

HTTPS reference images accessible for at least 24 hours. Use get_files for workspace uploads. Portrait review is automatic.

minItems: 1 · maxItems: 9

`prompt` string · required

Describe the motion in at most 4,000 characters; reference inputs as @image1, @image2, etc. Oversized prompts are rejected, not truncated.

minLength: 1 · maxLength: 4000

`resolution` string · optional

Value supplied for resolution.

enum: 480p, 720p, 1080p

### Output

`content_type` string

Returned content type value.

`duration_seconds` number

Returned duration seconds value.

`model` string

Returned model 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-portrait",
  "input": {
    "prompt": "Use the landscape in @image1. A gentle breeze moves through the grass while the camera slowly pushes forward. Preserve the scene and natural lighting.",
    "duration": 5,
    "image_urls": [
      "https://images.unsplash.com/photo-1470770841072-f978cf4d019e?w=1280"
    ],
    "resolution": "480p",
    "aspect_ratio": "16:9"
  }
}
```

### Output

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

**Errors and limitations**

- `invalid_input`: The video settings or image references are invalid.Use HTTPS image URLs and the durations and resolutions shown by inspect.
- `upstream_error`: The video could not be delivered. Your wallet was not charged.Portrait references must pass review. Contact support with the run ID if the problem persists.

---

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