Bytedance Dreamina V3.0 Pro Text To Video

Playground

Dreamina V3.0 Pro turns text or image prompts into 1080P professional videos with natural dynamics, diverse styles, and multi-scene narratives. Ready REST API; best performance, no coldstarts, affordable pricing.

Features

ByteDance Dreamina V3.0 Pro — Text-to-Video

Dreamina V3.0 Pro Text-to-Video is ByteDance’s premium text-to-video generation model that creates stunning, cinematic videos from text descriptions. Generate high-quality videos with smooth motion, rich detail, and flexible aspect ratios — perfect for professional content creation.

Why It Stands Out

Premium quality: Pro-level output with exceptional detail, motion, and visual fidelity.
Prompt Enhancer: Built-in AI-powered prompt optimization for better results.
Flexible aspect ratios: Wide range of formats from ultrawide 21:9 to ultra-tall 9:21.
Cinematic output: Produces professional-grade videos suitable for various platforms.
Reproducibility: Use the seed parameter to recreate exact results.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the video you want to generate.
aspect_ratio	No	Output aspect ratio (default: 16:9).
seed	No	Set for reproducibility; -1 for random.

Supported Aspect Ratios

Aspect Ratio	Best For
16:9	YouTube, widescreen displays
4:3	Classic format, presentations
1:1	Instagram posts, social media squares
3:4	Portrait photos, Pinterest
9:16	TikTok, Instagram Stories, Reels
21:9	Cinematic ultrawide content
9:21	Ultra-tall vertical content

How to Use

Write a prompt describing the scene, action, and style you want. Use the Prompt Enhancer for AI-assisted optimization.
Select aspect ratio — choose the format that fits your platform.
Set a seed (optional) for reproducible results.
Click Run and wait for your video to generate.
Preview and download the result.

Best Use Cases

Social Media Content — Create platform-optimized videos for any channel.
Marketing & Advertising — Produce high-quality promotional videos and ad creatives.
Film & Storytelling — Generate cinematic scenes for short films and narratives.
Travel & Lifestyle — Create immersive visual content for travel and lifestyle brands.
Music Videos — Generate visual content for songs and audio tracks.

Pricing

Output	Price
Per video	$0.60

Pro Tips for Best Quality

Be detailed in your prompt — describe subject, action, environment, lighting, and mood.
Include atmospheric details like weather, time of day, and sensory descriptions.
Use cinematic keywords like “snow-capped peaks,” “colorful prayer flags,” or “crisp mountain air.”
Choose the right aspect ratio for your target platform before generating.
Fix the seed when iterating to compare different prompt variations.

Notes

Processing time varies based on current queue load.
Please ensure your prompts comply with content guidelines.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/bytedance/dreamina-v3.0-pro/text-to-video" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "aspect_ratio": "16:9",
    "seed": -1
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

Parameter	Type	Required	Default	Range	Description
prompt	string	Yes		-	The positive prompt for the generation.
aspect_ratio	string	No	16:9	16:9, 4:3, 1:1, 3:4, 9:16, 21:9, 9:21	The aspect ratio of the generated media.
seed	integer	No	-1	-1 ~ 2147483647	The random seed to use for the generation. -1 means a random seed will be used.

Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data.id	string	Unique identifier for the prediction, Task Id
data.model	string	Model ID used for the prediction
data.outputs	array	Array of URLs to the generated content (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.has_nsfw_contents	array	Array of boolean values indicating NSFW detection for each output
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Result Request Parameters

Parameter	Type	Required	Default	Description
id	string	Yes	-	Task ID

Result Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data	object	The prediction data object containing all details
data.id	string	Unique identifier for the prediction, the ID of the prediction to get
data.model	string	Model ID used for the prediction
data.outputs	string	Array of URLs to the generated content (empty when status is not completed).
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Bytedance Dreamina V3.0 Pro Image To Video Bytedance Dreamina V3.0 Text To Image