# Seedance 2.5 Image To Video > AI model for generating video content ## Overview - **Model ID**: `seedance-2-5-image-to-video` - **Category**: video - **Provider**: byteplus - **Source Type**: Closed Source Model - **Status**: model_ready - **Screenshot**: `https://assets.modelslab.ai/generations/4bd9972c-2bb0-4dd7-afad-5552cc9d62fa.webp` ## API Information This model can be used via our HTTP API. See the API documentation and usage examples below. ### Endpoint - **URL**: `https://modelslab.com/api/v7/video-fusion/image-to-video` - **Method**: POST ### Parameters - **`init_image`** (required): Upload upto 9 reference image - Type: array - **`prompt`** (required): Text description of the video you want to generate - Type: textarea - Example: Enter prompt for video - **`aspect_ratio`** (required): - Type: select (options: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16) - **`resolution`** (required): - Type: select (options: 720P, 480P) - **`duration`** (required): Choose the duration between 5-30 seconds - Type: number (range: 5-30) ## Usage Examples ### cURL ```bash curl --request POST \ --url https://modelslab.com/api/v7/video-fusion/image-to-video \ --header "Content-Type: application/json" \ --data '{ "key": "YOUR_API_KEY", "model_id": "seedance-2-5-image-to-video", "prompt": "A cinematic hip-hop / rap music video with photorealistic texture, a premium tone, and a seaside setting. Build the image from @Image1 : a band performs on a golden beach by the shore where waves break - a lead vocalist grips a microphone and sings passionately, with the mic stand planted in wet sand; one guitarist stands on the left side of the frame, another guitarist on the right side, and a drummer sits behind a drum kit in the back, playing. A vast coastline spreads behind them, rolling waves surge in layers, and a huge warm golden-hour sunset slants across the beach, sparkling on the water. Sea mist and salty humidity float in the air. The lead vocalist in a red tracksuit raps rhythmically toward the camera - lip shapes and jaw movement precisely match every word, and the head nods hard to the beat, driving the entire flow. The musicians sway and groove with the rhythm while waves crash behind them. This is a bright, energetic rap track - fast delivery, confident attitude, and a powerful beat. Use HARD CUTS on the beat, with dual contrast on every cut (both shot size and camera type change at the same time). Lyrics (the lead vocalist sings the following "hello" in each language in order, with precise lip sync): English: "Hello" Chinese: "你好" Japanese: "こんにちは" Korean: "안녕하세요" Portuguese: "Olá" Thai: "สวัสดี" Spanish: "Hola" Arabic: "مرحبا" Shot 1 [0:00-0:03] - Low-angle extreme wide establishing shot. A Steadicam slowly pushes in through golden sunset light and sea mist, with waves surging behind the band. Lyric line 1 (English "Hello"). Hard cut. Shot 2 [0:03-0:05] - Close-up of the red-tracksuit lead vocalist rapping into the camera, entering with a handheld whip pan, with the sparkling ocean blurred in the background. Lyric line 2 (Chinese "你好"). Hard cut. Shot 3 [0:05-0:08] - Macro insert shot, locked-off camera, a guitarist's fingers rapidly picking the strings as grains of sand and salty mist sweep past the foreground. Lyric line 3 (Japanese "こんにちは"). Hard cut. Shot 4 [0:08-0:10] - 3/4 side medium shot of one musician, slow prowling orbit, with instrument hardware and wet highlights reflecting the low slanting sunset over the sea. Lyric line 4 (Korean "안녕하세요"). Hard cut. Shot 5 [0:10-0:13] - A musician by the shore; a fast lateral dolly move sweeps past them, they turn toward the camera, and a wave breaks behind them. Lyric line 5 (Portuguese "Olá"). Hard cut. Shot 6 [0:13-0:15] - The drummer by the water, handheld fast tilt-up, sea wind and spray blowing through their hair as they groove and strike the drums on the beat. Lyric line 6 (Thai "สวัสดี"). Hard cut. Shot 7 [0:15-0:18] - Tight aggressive push-in on the red-tracksuit lead vocalist at the height of the flow, aggressive handheld, the dusk ocean behind them silhouetting the band. Lyric line 7 (Spanish "Hola"). Hard cut. Shot 8 [0:18-0:20] - Heroic extreme wide shot of the full band, aggressive handheld push-in. The vocalist and musicians step toward the camera on the beat, waves break, and golden sunset light blooms behind the whole band. Lyric line 8 (Arabic "مرحبا"). White balance 4000K, teal-and-amber color grade, 35mm, shallow depth of field, film grain, diffused sea mist, golden-hour glow. Solid, premium, high-end texture. Rhythmic rap performance, precise lip sync, head nodding to the beat. No subtitles, no text overlays, no dissolve transitions, no duplicated people, only hard cuts. Total duration 20 seconds.", "aspect_ratio": "21:9", "resolution": "720p", "duration": "5" }' ``` ### Python ```python import requests response = requests.post( "https://modelslab.com/api/v7/video-fusion/image-to-video", headers={ "Content-Type": "application/json" }, json={ "key": "YOUR_API_KEY", "model_id": "seedance-2-5-image-to-video", "prompt": "A cinematic hip-hop / rap music video with photorealistic texture, a premium tone, and a seaside setting. Build the image from @Image1 : a band performs on a golden beach by the shore where waves break - a lead vocalist grips a microphone and sings passionately, with the mic stand planted in wet sand; one guitarist stands on the left side of the frame, another guitarist on the right side, and a drummer sits behind a drum kit in the back, playing. A vast coastline spreads behind them, rolling waves surge in layers, and a huge warm golden-hour sunset slants across the beach, sparkling on the water. Sea mist and salty humidity float in the air. The lead vocalist in a red tracksuit raps rhythmically toward the camera - lip shapes and jaw movement precisely match every word, and the head nods hard to the beat, driving the entire flow. The musicians sway and groove with the rhythm while waves crash behind them. This is a bright, energetic rap track - fast delivery, confident attitude, and a powerful beat. Use HARD CUTS on the beat, with dual contrast on every cut (both shot size and camera type change at the same time). Lyrics (the lead vocalist sings the following "hello" in each language in order, with precise lip sync): English: "Hello" Chinese: "你好" Japanese: "こんにちは" Korean: "안녕하세요" Portuguese: "Olá" Thai: "สวัสดี" Spanish: "Hola" Arabic: "مرحبا" Shot 1 [0:00-0:03] - Low-angle extreme wide establishing shot. A Steadicam slowly pushes in through golden sunset light and sea mist, with waves surging behind the band. Lyric line 1 (English "Hello"). Hard cut. Shot 2 [0:03-0:05] - Close-up of the red-tracksuit lead vocalist rapping into the camera, entering with a handheld whip pan, with the sparkling ocean blurred in the background. Lyric line 2 (Chinese "你好"). Hard cut. Shot 3 [0:05-0:08] - Macro insert shot, locked-off camera, a guitarist's fingers rapidly picking the strings as grains of sand and salty mist sweep past the foreground. Lyric line 3 (Japanese "こんにちは"). Hard cut. Shot 4 [0:08-0:10] - 3/4 side medium shot of one musician, slow prowling orbit, with instrument hardware and wet highlights reflecting the low slanting sunset over the sea. Lyric line 4 (Korean "안녕하세요"). Hard cut. Shot 5 [0:10-0:13] - A musician by the shore; a fast lateral dolly move sweeps past them, they turn toward the camera, and a wave breaks behind them. Lyric line 5 (Portuguese "Olá"). Hard cut. Shot 6 [0:13-0:15] - The drummer by the water, handheld fast tilt-up, sea wind and spray blowing through their hair as they groove and strike the drums on the beat. Lyric line 6 (Thai "สวัสดี"). Hard cut. Shot 7 [0:15-0:18] - Tight aggressive push-in on the red-tracksuit lead vocalist at the height of the flow, aggressive handheld, the dusk ocean behind them silhouetting the band. Lyric line 7 (Spanish "Hola"). Hard cut. Shot 8 [0:18-0:20] - Heroic extreme wide shot of the full band, aggressive handheld push-in. The vocalist and musicians step toward the camera on the beat, waves break, and golden sunset light blooms behind the whole band. Lyric line 8 (Arabic "مرحبا"). White balance 4000K, teal-and-amber color grade, 35mm, shallow depth of field, film grain, diffused sea mist, golden-hour glow. Solid, premium, high-end texture. Rhythmic rap performance, precise lip sync, head nodding to the beat. No subtitles, no text overlays, no dissolve transitions, no duplicated people, only hard cuts. Total duration 20 seconds.", "aspect_ratio": "21:9", "resolution": "720p", "duration": "5" } ) print(response.json()) ``` ### JavaScript ```javascript fetch("https://modelslab.com/api/v7/video-fusion/image-to-video", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ "key": "YOUR_API_KEY", "model_id": "seedance-2-5-image-to-video", "prompt": "A cinematic hip-hop / rap music video with photorealistic texture, a premium tone, and a seaside setting. Build the image from @Image1 : a band performs on a golden beach by the shore where waves break - a lead vocalist grips a microphone and sings passionately, with the mic stand planted in wet sand; one guitarist stands on the left side of the frame, another guitarist on the right side, and a drummer sits behind a drum kit in the back, playing. A vast coastline spreads behind them, rolling waves surge in layers, and a huge warm golden-hour sunset slants across the beach, sparkling on the water. Sea mist and salty humidity float in the air. The lead vocalist in a red tracksuit raps rhythmically toward the camera - lip shapes and jaw movement precisely match every word, and the head nods hard to the beat, driving the entire flow. The musicians sway and groove with the rhythm while waves crash behind them. This is a bright, energetic rap track - fast delivery, confident attitude, and a powerful beat. Use HARD CUTS on the beat, with dual contrast on every cut (both shot size and camera type change at the same time). Lyrics (the lead vocalist sings the following "hello" in each language in order, with precise lip sync): English: "Hello" Chinese: "你好" Japanese: "こんにちは" Korean: "안녕하세요" Portuguese: "Olá" Thai: "สวัสดี" Spanish: "Hola" Arabic: "مرحبا" Shot 1 [0:00-0:03] - Low-angle extreme wide establishing shot. A Steadicam slowly pushes in through golden sunset light and sea mist, with waves surging behind the band. Lyric line 1 (English "Hello"). Hard cut. Shot 2 [0:03-0:05] - Close-up of the red-tracksuit lead vocalist rapping into the camera, entering with a handheld whip pan, with the sparkling ocean blurred in the background. Lyric line 2 (Chinese "你好"). Hard cut. Shot 3 [0:05-0:08] - Macro insert shot, locked-off camera, a guitarist's fingers rapidly picking the strings as grains of sand and salty mist sweep past the foreground. Lyric line 3 (Japanese "こんにちは"). Hard cut. Shot 4 [0:08-0:10] - 3/4 side medium shot of one musician, slow prowling orbit, with instrument hardware and wet highlights reflecting the low slanting sunset over the sea. Lyric line 4 (Korean "안녕하세요"). Hard cut. Shot 5 [0:10-0:13] - A musician by the shore; a fast lateral dolly move sweeps past them, they turn toward the camera, and a wave breaks behind them. Lyric line 5 (Portuguese "Olá"). Hard cut. Shot 6 [0:13-0:15] - The drummer by the water, handheld fast tilt-up, sea wind and spray blowing through their hair as they groove and strike the drums on the beat. Lyric line 6 (Thai "สวัสดี"). Hard cut. Shot 7 [0:15-0:18] - Tight aggressive push-in on the red-tracksuit lead vocalist at the height of the flow, aggressive handheld, the dusk ocean behind them silhouetting the band. Lyric line 7 (Spanish "Hola"). Hard cut. Shot 8 [0:18-0:20] - Heroic extreme wide shot of the full band, aggressive handheld push-in. The vocalist and musicians step toward the camera on the beat, waves break, and golden sunset light blooms behind the whole band. Lyric line 8 (Arabic "مرحبا"). White balance 4000K, teal-and-amber color grade, 35mm, shallow depth of field, film grain, diffused sea mist, golden-hour glow. Solid, premium, high-end texture. Rhythmic rap performance, precise lip sync, head nodding to the beat. No subtitles, no text overlays, no dissolve transitions, no duplicated people, only hard cuts. Total duration 20 seconds.", "aspect_ratio": "21:9", "resolution": "720p", "duration": "5" }) }) .then(response => response.json()) .then(data => console.log(data)); ``` ## Integration Options ### CLI Install: `curl -fsSL https://modelslab.sh/install.sh | sh` or `brew install modelslab/tap/modelslab` ```bash modelslab auth login # Authenticate modelslab models search "seedance-2-5-image-to-video" # Find this model modelslab models detail --id seedance-2-5-image-to-video # Get model details modelslab generate image --prompt "..." --model seedance-2-5-image-to-video # Generate with model modelslab config set generation.default_model seedance-2-5-image-to-video # Set as default ``` - Website: https://modelslab.sh - GitHub: https://github.com/ModelsLab/modelslab-cli ### MCP Servers (Model Context Protocol) For Claude Code, Cursor, VS Code, Windsurf, and any MCP-compatible agent. - Generation: `https://modelslab.com/mcp/v7` (API key auth, 23 tools) - Agent Control Plane: `https://modelslab.com/mcp/agents` (Bearer token auth, 10 tools) Claude Code config (`~/.claude/settings.json`): ```json { "mcpServers": { "modelslab-v7": { "url": "https://modelslab.com/mcp/v7", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ``` - Documentation: https://docs.modelslab.com/mcp-web-api/overview ### Agent Skills Install skill files directly into AI coding agents: ```bash npx skills add modelslab/skills --all # All skills npx skills add modelslab/skills --skill image-generation # Specific skill npx skills add modelslab/skills --all -a claude-code -a cursor # Target agents ``` - GitHub: https://github.com/ModelsLab/skills - Documentation: https://docs.modelslab.com/agent-skills ### SDKs - Python: `pip install modelslab` - TypeScript: `npm install modelslab` - PHP: `composer require modelslab/modelslab` - Go: `go get github.com/modelslab/modelslab-go` - Dart: `dart pub add modelslab` ## Links - [Model Playground](https://modelslab.com/models/byteplus/seedance-2-5-image-to-video) - [API Documentation](https://docs.modelslab.com) - [ModelsLab Platform](https://modelslab.com)