Bytedance Dreamina V3.0 Text To Image

Playground

ByteDance Dreamina V3.0 is a text-to-image model emphasizing upgraded visual effects, richer detail, and improved style accuracy to generate more aesthetic, faithful images from text prompts. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

ByteDance Dreamina v3.0 Text-to-Image

Transform your ideas into stunning visuals with ByteDance’s Dreamina v3.0 text-to-image model. Featuring flexible custom dimensions and strong artistic capabilities, it excels at creating stylized illustrations, posters, and creative imagery at an affordable price.

Looking for the latest version? Try Dreamina v3.1 Text-to-Image for enhanced generation quality.

Why It Looks Great

Strong artistic style: Excels at stylized illustrations, poster designs, and graphic artwork.
Custom dimensions: Precise control over width and height for any aspect ratio or resolution.
Prompt Enhancer: Built-in tool to automatically refine and expand your descriptions.
Prompt expansion option: Enable automatic prompt enhancement for richer outputs.
Reproducible results: Use the seed parameter to recreate exact outputs or explore variations.
Budget-friendly: High-quality stylized generation at a competitive price point.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the image you want to generate.
size	No	Custom dimensions with separate width and height controls.
width	No	Output width in pixels (e.g., 1024).
height	No	Output height in pixels (e.g., 720).
seed	No	Random seed for reproducibility. Use -1 for random.
enable_prompt_expansion	No	API only: Waits for image generation and returns it directly in the response.

How to Use

Write your prompt — describe your image with details about subject, style, colors, and composition.
Use Prompt Enhancer (optional) — click to automatically enrich your description.
Set dimensions — adjust width and height sliders to your desired resolution and aspect ratio.
Set seed (optional) — use -1 for random, or a specific number to reproduce results.
Run — click the button to generate.
Download — preview and save your image.

Pricing

Flat rate per image generation.

Output	Cost
Per image	$0.027

Best Use Cases

Poster & Graphic Design — Create stylized posters, Art Deco illustrations, and graphic artwork.
Illustration — Generate artistic illustrations with bold shapes and distinctive styles.
Concept Art — Visualize architectural concepts, fantasy environments, and creative ideas.
Marketing Materials — Produce eye-catching visuals for campaigns and promotional content.
Social Media Graphics — Create platform-optimized visuals with custom dimensions.

Example Prompts

“An Art Deco poster illustration of a fantastical skyscraper at night, reaching into the clouds. The building features strong geometric shapes and a symmetrical, stepped-back structure. The sky is a deep indigo blue, adorned with stylized stars. Bold golden lines.”
“Vintage travel poster of a tropical island, retro color palette, bold typography space, mid-century modern illustration style”
“Minimalist geometric portrait, overlapping shapes in warm earth tones, Bauhaus-inspired design”
“Fantasy castle on a floating island, watercolor illustration style, dreamy pastel colors, whimsical atmosphere”
“Noir detective scene in a rainy city, dramatic shadows, monochromatic with selective red highlights, graphic novel aesthetic”

Pro Tips for Best Results

Specify artistic styles explicitly — “Art Deco”, “minimalist”, “vintage poster”, “geometric”.
Describe color palettes — “bold golden lines”, “deep indigo blue”, “warm earth tones”.
Include composition details — “symmetrical”, “stepped-back structure”, “geometric shapes”.
Use the Prompt Enhancer to add stylistic details you might not have considered.
Landscape dimensions (1024×720) work great for posters and banners.
Keep the seed constant when testing prompt variations to isolate changes.

Notes

The enable_prompt_expansion option is only available through the API.
Generation time may vary based on resolution and current queue load.
The model excels at stylized and illustrative content — lean into artistic prompts.

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/text-to-image" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "size": "1328*1328",
    "seed": -1,
    "enable_prompt_expansion": true,
    "enable_base64_output": false,
    "enable_sync_mode": false
}'

# 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.
size	string	No	1328*1328	512 ~ 2048 per dimension	The size of the generated media in pixels (width*height).
seed	integer	No	-1	-1 ~ 2147483647	The random seed to use for the generation. -1 means a random seed will be used.
enable_prompt_expansion	boolean	No	true	-	If set to true, the function will wait for the image to be generated and uploaded before returning the response. It allows you to get the image directly in the response. This property is only available through the API.
enable_base64_output	boolean	No	false	-	If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API.
enable_sync_mode	boolean	No	false	-	If set to true, the function will wait for the result to be generated and uploaded before returning the response. It allows you to get the result directly in the response. This property is only available through the API.

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 Text To Video Bytedance Dreamina V3.0 Text To Video 1080p