Seedance 2.0 Mini Text to Video API

ByteDance Seedance 2.0 Mini Text-to-Video

ByteDance Seedance 2.0 Mini Text-to-Video generates videos from natural-language prompts, with optional reference images, videos, and audio for stronger visual and motion guidance. Describe the scene, action, camera movement, and mood, then choose aspect ratio, resolution, duration, and audio generation settings.

Need to generate from a start image instead? Try ByteDance Seedance 2.0 Mini Image-to-Video.

Why Choose This?

Prompt-based video generation
Generate videos directly from text prompts describing the scene, action, camera movement, and mood.
Reference-guided generation
Add reference images, videos, or audio to guide visual style, characters, scene composition, motion, or audio direction.
Native audio generation
Generate synchronized audio together with the output video using generate_audio.
Flexible aspect ratios
Supports 16:9, 9:16, 4:3, 3:4, 1:1, and 21:9 for different video layouts.
Resolution options
Generate videos in 480p, 720p, 1080p, or 4k.
Web search option
Enable enable_web_search when the prompt needs real-time information.

Parameters

Parameter	Required	Description
prompt	Yes	Describe the scene, action, camera movement, and mood for the video.
reference_images	No	Reference image URLs to guide visual style, characters, or scene composition. Supports up to `9` images.
reference_videos	No	Reference video URLs. Supports up to `3` videos, with total reference video length no more than `15` seconds.
reference_audios	No	Reference audio URLs. Supports up to `3` audio files, with total reference audio length no more than `15` seconds.
aspect_ratio	No	Output aspect ratio: `16:9`, `9:16`, `4:3`, `3:4`, `1:1`, or `21:9`. Default: `16:9`.
resolution	No	Output video resolution: `480p`, `720p`, `1080p`, or `4k`. Default: `720p`.
duration	No	Duration of the generated video in seconds. Range: `4–15`. Default: `5`.
enable_web_search	No	Enable web search for real-time information. Default: `false`.
generate_audio	No	Whether to generate native audio synchronized with the output video. Default: `true`.

How to Use

Write your prompt — Describe the scene, subject, action, camera movement, lighting, and mood.
Add references optional — Upload reference images, videos, or audio when you want stronger guidance.
Choose aspect ratio — Select the output format, such as 16:9, 9:16, or 1:1.
Choose resolution — Select 480p, 720p, 1080p, or 4k.
Set duration — Choose a duration between 4 and 15 seconds.
Configure audio optional — Keep generate_audio enabled for synchronized native audio, or disable it if audio is not needed.
Submit — Generate the final video.

Example Prompt

A cinematic night market scene, warm lantern light, people walking through a narrow street, soft camera tracking movement, steam rising from food stalls, realistic atmosphere, gentle ambient motion, rich colors, detailed urban background.

Pricing

Per 5 Seconds

Resolution	Cost
480p	$0.30
720p	$0.60
1080p	$1.50
4k	$3.00

Per Second

Resolution	Cost
480p	$0.06
720p	$0.12
1080p	$0.30
4k	$0.60

Example Costs

Resolution	4s	5s	10s	15s
480p	$0.24	$0.30	$0.60	$0.90
720p	$0.48	$0.60	$1.20	$1.80
1080p	$1.20	$1.50	$3.00	$4.50
4k	$2.40	$3.00	$6.00	$9.00

Best Use Cases

Text-to-video generation — Create short videos directly from natural-language prompts.
Reference-to-video workflows — Use reference images, videos, or audio to guide the generated video.
Cinematic short clips — Generate videos with camera movement, atmosphere, and synchronized audio.
Character and style consistency — Use reference images to guide characters, visual style, or scene composition.
Motion and audio guidance — Use reference videos or audio to guide motion direction or sound style.
Social media content — Generate vertical, square, landscape, or ultra-wide video formats.
Creative prototyping — Test scene ideas, visual concepts, and motion directions quickly.

Pro Tips

Be specific about scene, action, camera movement, lighting, and mood.
Use reference images when character, style, or composition consistency matters.
Use reference videos when motion direction is important.
Use reference audio when the generated video should follow a specific audio style or sound direction.
Use 480p for quick testing, 720p for standard output, 1080p for higher-resolution results, and 4k for maximum-resolution output.
Keep generate_audio enabled when you want the output video to include synchronized native audio.
Choose an aspect ratio based on the final format, such as 9:16 for vertical content or 16:9 for widescreen video.

Notes

Although this endpoint is named Text-to-Video, it also supports reference-to-video workflows through reference_images, reference_videos, and reference_audios.

Related Models

ByteDance Seedance 2.0 Mini Image-to-Video — Generate video from a start image and prompt.

Seedance 2.0 Mini Text To Video API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/bytedance/seedance-2.0-mini/text-to-video with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read URLs from data.outputs. Examples for Seedance 2.0 Mini Text To Video below.

HTTP example

# Submit the prediction
curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.wavespeed.ai/api/v3/bytedance/seedance-2.0-mini/text-to-video" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5,
    "enable_web_search": false,
    "generate_audio": true
}'

# Wait at least 2 seconds, then poll. Safe GET requests may be retried.
curl --fail-with-body --connect-timeout 10 --max-time 30 \
  --retry 4 --retry-all-errors --retry-delay 1 \
  -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# Start at 2 seconds and increase the interval for long-running tasks.
# Stop on completed, failed, cancelled, or timeout.

Node.js example

// npm install wavespeed
const { Client } = require('wavespeed');

const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
const client = new Client(apiKey);

try {
  const result = await client.run("bytedance/seedance-2.0-mini/text-to-video", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "aspect_ratio": "16:9",
        "resolution": "720p",
        "duration": 5,
        "enable_web_search": false,
        "generate_audio": true
}, {
    timeout: 3600,
    pollInterval: 2.0,
  });
  console.log(result.outputs);
} catch (error) {
  console.error('Generation failed:', error);
  process.exitCode = 1;
}

Python example

# pip install wavespeed
import os
from wavespeed import Client

client = Client(api_key=os.environ["WAVESPEED_API_KEY"])

try:
    output = client.run(
        "bytedance/seedance-2.0-mini/text-to-video",
        {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5,
    "enable_web_search": false,
    "generate_audio": true
},
        timeout=3600.0,
        poll_interval=2.0,
    )
    print(output["outputs"])
except Exception as error:
    raise SystemExit(f"Generation failed: {error}") from error

Seedance 2.0 Mini Text To Video API — Frequently asked questions

What is the Seedance 2.0 Mini Text To Video API?

Seedance 2.0 Mini Text To Video is a ByteDance model for video generation, exposed as a REST API on WaveSpeedAI. Seedance 2.0 Mini Text to Video is ByteDance's faster, lower-cost text-to-video model for cinematic multi-shot videos. It generates narrative sequences from text prompts with AI camera control, consistent characters across scenes, 480P / 720P / 1080P / 4K output, 4-15s duration, and flexible aspect ratios. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Seedance 2.0 Mini Text To Video API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/bytedance/bytedance-seedance-2.0-mini-text-to-video.

How much does Seedance 2.0 Mini Text To Video cost per run?

Seedance 2.0 Mini Text To Video starts at $0.60 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Seedance 2.0 Mini Text To Video accept?

Key inputs: `prompt`, `aspect_ratio`, `resolution`, `duration`, `reference_images`, `enable_web_search`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/bytedance/bytedance-seedance-2.0-mini-text-to-video.

How do I get started with the Seedance 2.0 Mini Text To Video API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Seedance 2.0 Mini Text To Video outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (ByteDance). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

サンプルすべて表示

関連モデル

README