bytedance/seedance/1.0/pro/fast/image-to-video
Seedance 1.0 Pro by Bytedance - animate still images into dynamic videos with AI. Transform photos into cinematic clips with natural motion, camera movement, and optional audio generation.
PNG, JPEG, WebP, or GIF · 20 MiB maximum
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runbytedance/seedance/1.0/pro/fast/image-to-videoInput Schema
8 parameters · 2 required · 6 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | Required | The URL of the image used to generate video |
prompt | string | Required | The text prompt used to generate the video |
seed | integer | Optional | Random seed to control video generation. Use -1 for random. |
duration | integer | Optional | Duration of the video in seconds · Options: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 · Default: 5 23456789101112 |
num_frames | integer | Optional | The number of frames to generate. If provided, will override duration. · Min: 29 · Max: 289 |
resolution | string | Optional | Video resolution - 480p for faster generation, 720p for balance, 1080p for higher quality · Options: 480p, 720p, 1080p · Default: "1080p" 480p720p1080p |
aspect_ratio | string | Optional | The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16 |
camera_fixed | boolean | Optional | Whether to fix the camera position · Default: false |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "bytedance/seedance/1.0/pro/fast/image-to-video",
"image": "https://static.sandbase.ai/examples/bytedance/seedance/1.0/pro/fast/image-to-video/input_image_0.png",
"prompt": "Bathed in a stark spotlight, a lone ballet dancer takes center stage. Her movements, precise and graceful, tell a story of passion and dedication against the velvet darkness. The scene evokes a sense of intimacy, highlighting the raw emotion and artistry of her performance.",
"duration": 5,
"resolution": "1080p",
"camera_fixed": false
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Seedance 1.0 Pro Fast I2V
Seedance 1.0 Pro Fast Image-to-Video animates a supplied key visual with an emphasis on rapid creative iteration and coherent motion. The source frame anchors character identity, setting, and composition, while the prompt directs action, camera movement, pacing, atmosphere, and how the shot develops over time.
The Seedance family is designed for fluid motion, strong prompt following, and cinematic camera language, including shots with several actions or a changing viewpoint. The Fast route makes those strengths useful during production exploration, when teams need to compare movement concepts quickly before selecting a final treatment.
Highlights
Fluid subject motion. Produces natural movement with coherent body, object, and environmental dynamics from a still image.
Cinematic camera language. Follows directions for pushes, pans, tracking, orbiting, locked shots, and other deliberate camera behavior.
Strong prompt adherence. Coordinates action, pacing, atmosphere, and visual development across detailed motion briefs.
Narrative shot development. Handles evolving action and viewpoint changes while keeping the source subject and scene recognizable.
Pricing
| Billing unit | Price |
|---|---|
| Per request | $0.243 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| A still image should anchor the video's subject and composition | The whole scene should be invented from text alone |
| A managed asynchronous result is suitable for the production pipeline | A synchronous, interactive editor is essential |
| The documented controls cover the required duration, framing, or format | The project needs controls outside this endpoint's schema |
| Creative iteration benefits from a repeatable request structure | Exact deterministic pixels, frames, geometry, or samples are mandatory |
| A finished downloadable media asset is the desired deliverable | Editable source layers or a native project file are required |
Prompt Guide
For image-conditioned generation, state the intended result first, then add the subject or source treatment, progression, style, and delivery constraints. Keep one creative variable per phrase, use the documented field names for controls, and change one setting at a time when comparing results.
{
"aspect_ratio": "21:9",
"duration": 5,
"image": "https://static.sandbase.ai/examples/bytedance/seedance/1.0/pro/fast/image-to-video/input_image_0.png",
"prompt": "Bathed in a stark spotlight, a lone ballet dancer takes center stage. Her movements, precise and graceful, tell a story of passion and dedication against the velvet darkness. The scene evokes a sense of intimacy, highlighting the raw emotion and artistry of her performance.",
"resolution": "1080p"
}
Technical Specs
| Spec | Value |
|---|---|
| Model ID | bytedance/seedance/1.0/pro/fast/image-to-video |
| Inputs | aspect_ratio, camera_fixed, duration, image, num_frames, prompt, resolution, seed |
| Required inputs | prompt, image |
| Output fields | content_type, url |
| Execution | Async (submit, then poll for result) |
| Duration | 2 / 3 / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 |
| Resolution | 480p / 720p / 1080p |
| Aspect Ratio | 21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16 |
Related Models
bytedance/seedance/1.0/pro/fast/text-to-video— Compare a nearby route in the same local model family.bytedance/seedance/1.0/pro/image-to-video— Compare a nearby route in the same local model family.bytedance/seedance/1.0/pro/text-to-video— Compare a nearby route in the same local model family.