ByteDance
Seedream API
Seedream is ByteDance Seed's family of image generation and editing models. Compare the versions published on Wizzx by price and editing capability, then call any of them with the same API key.
- Versions
- 3
- Starting price
- $0.03/image
- Below official price
- up to 14%
New accounts start with $0.20 in free credits.
Seedream models are developed by ByteDance. Wizzx provides API access to them and does not own the models. All trademarks belong to their respective owners.

Seedream example outputs

Generated with Seedream 4.5
aspect_ratio: 3:4resolution: 2KTry Seedream 4.5 in the PlaygroundPromptE-commerce hero image: a pair of white leather sneakers floating above a pastel blue podium, soft shadow below, clean studio lighting. A bold sans-serif headline "SPRING DROP" in the upper third and a small line "New colorways · Limited run" beneath it. Crisp, legible text, premium advertising look.
E-commerce hero image: a pair of white leather sneakers floating above a pastel blue podium, soft shadow below, clean studio lighting. A bold sans-serif headline "SPRING DROP" in the upper third and a small line "New colorways · Limited run" beneath it. Crisp, legible text, premium advertising look.

Generated with Seedream 5.0 Pro
aspect_ratio: 16:9resolution: 2Koutput_format: pngTry Seedream 5.0 Pro in the PlaygroundPromptA chalkboard menu in a cozy cafe titled "Today's Menu", listing six items with prices: "Flat White $4.50", "Matcha Latte $5.00", "Cold Brew $4.75", "Croissant $3.25", "Banana Bread $3.75", "Avocado Toast $8.50". Hand-lettered chalk style, neat alignment, warm pendant lights in the background. All text must be legible and spelled exactly as written.
A chalkboard menu in a cozy cafe titled "Today's Menu", listing six items with prices: "Flat White $4.50", "Matcha Latte $5.00", "Cold Brew $4.75", "Croissant $3.25", "Banana Bread $3.75", "Avocado Toast $8.50". Hand-lettered chalk style, neat alignment, warm pendant lights in the background. All text must be legible and spelled exactly as written.

Generated with Seedream 4.0
aspect_ratio: 4:3resolution: 2KTry Seedream 4.0 in the PlaygroundPromptMinimal school textbook illustration of a volcano cut in half vertically, on a white background, landscape 4:3. Flat vector style, soft brown rock and orange magma. Show the entire volcano and a complete small oval underground magma reservoir with white margin underneath. A narrow straight orange vertical tube connects the reservoir to the summit opening. A gray cloud floats above the summit. There are exactly FOUR black text labels total and exactly FOUR thin straight horizontal leader lines. Left lower label "Magma chamber": its horizontal line ends in the orange oval underground reservoir. Right middle label "Conduit": its horizontal line ends in the orange vertical tube. Left upper label "Crater": its horizontal line ends at the summit opening. Right top label "Ash cloud": its horizontal line ends inside the gray cloud. Each label appears exactly once. Only these four labels are present. Large readable sans-serif type. Simple uncluttered educational layout.
Minimal school textbook illustration of a volcano cut in half vertically, on a white background, landscape 4:3. Flat vector style, soft brown rock and orange magma. Show the entire volcano and a complete small oval underground magma reservoir with white margin underneath. A narrow straight orange vertical tube connects the reservoir to the summit opening. A gray cloud floats above the summit. There are exactly FOUR black text labels total and exactly FOUR thin straight horizontal leader lines. Left lower label "Magma chamber": its horizontal line ends in the orange oval underground reservoir. Right middle label "Conduit": its horizontal line ends in the orange vertical tube. Left upper label "Crater": its horizontal line ends at the summit opening. Right top label "Ash cloud": its horizontal line ends inside the gray cloud. Each label appears exactly once. Only these four labels are present. Large readable sans-serif type. Simple uncluttered educational layout.
Compare Seedream API versions
| Version | Best for | Wizzx from | Official from | Model ID |
|---|---|---|---|---|
| Seedream 4.0 API | Generate, edit, and fuse up to 14 reference images with ByteDance Seedream 4.0 at 1K, 2K, or 4K, with up to 15 images per request. | $0.03/image | seedream-4 | |
| Seedream 4.5 API | Edit across up to 14 references with ByteDance Seedream 4.5, which keeps reference detail and renders dense text and typography more reliably than 4.0. | $0.04/image | seedream-4.5 | |
| Seedream 5.0 Pro API 2K | Generate text-rich images or make precise single-reference edits with ByteDance Seedream 5.0 Pro at 1K, 1.5K, or 2K. | $0.044/image | — | seedream-5-pro |
Wizzx prices are the lowest tier of each version, read live from the pricing catalog. Official prices are the provider's list prices for comparable tiers where published. Resolution, duration and audio change the tier, so compare the full tier list on each version page.
Seedream versions side by side
Inputs and output options each version accepts on Wizzx, read from the request schema.
| Version | Seedream 4.0 | Seedream 4.5 | Seedream 5.0 Pro |
|---|---|---|---|
| Reference media | up to 14, optional | up to 14, optional | up to 1, optional |
| Resolution | 1K · 2K · 4K | 1K · 2K · 4K | 1K · 1.5K · 2K |
| Aspect ratios | 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 · 21:9 | 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 · 21:9 | auto · 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 · 2:1 · 1:2 · 21:9 |
| Output format | — | — | jpeg · png |
Which Seedream version should I use?
Integrate the Seedream API
Create a server-side API key, submit the supported inputs for your chosen model, and keep the returned task ID to retrieve the result. Model pages link to the exact request contract.
- 1
Create an API key
Sign in and create a key in the dashboard. Set WIZZX_API_KEY in your server environment; never expose it in browser code.
- 2
Submit a task
Send a POST request to the model endpoint. A successful submission returns data.task_id; keep that ID before polling. Submission is not generation completion.
- 3
Retrieve the result
Replace YOUR_TASK_ID with the returned ID and query GET /api/v1/task/{task_id}. Wait for SUCCEEDED and read the output URLs. Stop on FAILED or REVIEW_REQUIRED; do not automatically resubmit an uncertain task.
Submit a Seedream 4.0 task
curl -X POST \
https://api.wizzx.ai/api/v1/task/submit/seedream-4 \
-H "Authorization: Bearer $WIZZX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"aspect_ratio": "1:1",
"resolution": "2K",
"batch_size": 1,
"watermark": false,
"prompt": "Minimal school textbook illustration of a volcano cut in half vertically, on a white background, landscape 4:3. Flat vector style, soft brown rock and orange magma. Show the entire volcano and a complete small oval underground magma reservoir with white margin underneath. A narrow straight orange vertical tube connects the reservoir to the summit opening. A gray cloud floats above the summit. There are exactly FOUR black text labels total and exactly FOUR thin straight horizontal leader lines. Left lower label \"Magma chamber\": its horizontal line ends in the orange oval underground reservoir. Right middle label \"Conduit\": its horizontal line ends in the orange vertical tube. Left upper label \"Crater\": its horizontal line ends at the summit opening. Right top label \"Ash cloud\": its horizontal line ends inside the gray cloud. Each label appears exactly once. Only these four labels are present. Large readable sans-serif type. Simple uncluttered educational layout."
}'const response = await fetch("https://api.wizzx.ai/api/v1/task/submit/seedream-4", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.WIZZX_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"aspect_ratio": "1:1",
"resolution": "2K",
"batch_size": 1,
"watermark": false,
"prompt": "Minimal school textbook illustration of a volcano cut in half vertically, on a white background, landscape 4:3. Flat vector style, soft brown rock and orange magma. Show the entire volcano and a complete small oval underground magma reservoir with white margin underneath. A narrow straight orange vertical tube connects the reservoir to the summit opening. A gray cloud floats above the summit. There are exactly FOUR black text labels total and exactly FOUR thin straight horizontal leader lines. Left lower label \"Magma chamber\": its horizontal line ends in the orange oval underground reservoir. Right middle label \"Conduit\": its horizontal line ends in the orange vertical tube. Left upper label \"Crater\": its horizontal line ends at the summit opening. Right top label \"Ash cloud\": its horizontal line ends inside the gray cloud. Each label appears exactly once. Only these four labels are present. Large readable sans-serif type. Simple uncluttered educational layout."
}),
});
const payload = await response.json();
const task = payload.data ?? payload;
const taskId = task.task_id;import os
import requests
response = requests.post(
"https://api.wizzx.ai/api/v1/task/submit/seedream-4",
headers={
"Authorization": f"Bearer {os.environ['WIZZX_API_KEY']}",
},
json={
"aspect_ratio": "1:1",
"resolution": "2K",
"batch_size": 1,
"watermark": False,
"prompt": "Minimal school textbook illustration of a volcano cut in half vertically, on a white background, landscape 4:3. Flat vector style, soft brown rock and orange magma. Show the entire volcano and a complete small oval underground magma reservoir with white margin underneath. A narrow straight orange vertical tube connects the reservoir to the summit opening. A gray cloud floats above the summit. There are exactly FOUR black text labels total and exactly FOUR thin straight horizontal leader lines. Left lower label \"Magma chamber\": its horizontal line ends in the orange oval underground reservoir. Right middle label \"Conduit\": its horizontal line ends in the orange vertical tube. Left upper label \"Crater\": its horizontal line ends at the summit opening. Right top label \"Ash cloud\": its horizontal line ends inside the gray cloud. Each label appears exactly once. Only these four labels are present. Large readable sans-serif type. Simple uncluttered educational layout."
},
)
payload = response.json()
task = payload.get("data", payload)
task_id = task["task_id"]curl https://api.wizzx.ai/api/v1/task/YOUR_TASK_ID \
-H "Authorization: Bearer $WIZZX_API_KEY"const response = await fetch("https://api.wizzx.ai/api/v1/task/YOUR_TASK_ID", {
headers: {
Authorization: `Bearer ${process.env.WIZZX_API_KEY}`,
},
});
const payload = await response.json();
const task = payload.data ?? payload;
// Poll until task.status is SUCCEEDED, then read task.result_urls (stop on FAILED or REVIEW_REQUIRED)import os
import requests
response = requests.get(
"https://api.wizzx.ai/api/v1/task/YOUR_TASK_ID",
headers={
"Authorization": f"Bearer {os.environ['WIZZX_API_KEY']}",
},
)
payload = response.json()
task = payload.get("data", payload)
# Poll until task["status"] == "SUCCEEDED", then read task["result_urls"] (stop on FAILED or REVIEW_REQUIRED)API integration questions
- Is this the official Seedream API?
- No. Seedream models are developed by ByteDance. Wizzx is an independent API platform that gives you access to them with one API key, an asynchronous task API and pay-as-you-go credits.
- What are the Seedream API model IDs?
- Submit tasks to POST /api/v1/task/submit/{model_id} with one of: seedream-4, seedream-4.5, seedream-5-pro.
- Am I charged if a task fails?
- No. Credits are reserved when you submit a task and refunded if it fails. You are only charged for successful tasks.
- Can I try the Seedream API for free?
- Yes. New accounts start with $0.20 in free credits, about 6 images with Seedream 4.0, the lowest-priced version.
Wizzx API
Start building with the Seedream API
New accounts get $0.20 in free credits. Pay as you go with no subscription, and failed tasks are refunded.