Seedream 5.0 Flash
doubao/seedream-v5.0-flash/text-to-image
Generate one image from a text prompt. $0.018 per image at all supported sizes; reference inputs are free.
Examples
Parameters
| Name | Type | Default | Constraints | Description |
|---|---|---|---|---|
| prompt *Prompt | textarea | — | ≤ 5000 chars | The positive prompt for the generation. |
| output_formatOutput Format | select | jpeg | jpeg | png | The format of the output image. |
| sizeSize | text | 2048x2048 | — | Specify the width and height pixel values of the generated image.Total pixel value range: [1280*720, 2048*2048*1.1025] |
Output fields
| Field | Type | Description |
|---|---|---|
| images | array<string> | Generated image URLs. |
API
Call this model through one unified REST API. Get a key on the API Keys page.
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-flash/text-to-image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "A cinematic futuristic city street at dusk after light rain, neon signs in English and Japanese reflecting on wet pavement, a stylish young woman in a transparent umbrella walking past a ramen shop, soft volumetric fog, detailed storefronts, realistic lighting, ultra-detailed, vibrant colors, natural skin tones, sharp focus",
"output_format": "jpeg",
"size": "2048x2048"
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-flash/text-to-image",
headers=HEADERS,
json={
"input": {
"prompt": "A cinematic futuristic city street at dusk after light rain, neon signs in English and Japanese reflecting on wet pavement, a stylish young woman in a transparent umbrella walking past a ramen shop, soft volumetric fog, detailed storefronts, realistic lighting, ultra-detailed, vibrant colors, natural skin tones, sharp focus",
"output_format": "jpeg",
"size": "2048x2048"
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 300s server-side.
deadline = time.time() + 360
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-flash/text-to-image", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"prompt": "A cinematic futuristic city street at dusk after light rain, neon signs in English and Japanese reflecting on wet pavement, a stylish young woman in a transparent umbrella walking past a ramen shop, soft volumetric fog, detailed storefronts, realistic lighting, ultra-detailed, vibrant colors, natural skin tones, sharp focus",
"output_format": "jpeg",
"size": "2048x2048"
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 300s server-side.
const deadline = Date.now() + 360 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);Documentation
Seedream 5.0 Flash
doubao/seedream-v5.0-flash/text-to-image
Generate one image from a text prompt. $0.018 per image at all supported sizes; reference inputs are free.
Pricing
BytePlus official list price: $0.018 per output image = 1.8 credits per output image. Input images are free. All supported sizes have the same unit price. USD 1 = 100 credits. Account discounts, if any, apply separately.
Each request generates one image and costs 1.8 credits ($0.018) before account discounts. Reference image count does not add a fee. Failed tasks are refunded.
Parameters
| Parameter | Required | Default / limits |
|---|---|---|
prompt | Yes | 5000 characters |
output_format | No | jpeg; jpeg, png |
size | No | 2048x2048 |
Use size for image dimensions. For generation/editing, explicit widthxheight values are supported: 921,600–4,624,220 total pixels, aspect ratio from 1:16 to 16:1. Examples: 1024x1024, 1536x1536, 2048x2048, 2048x1024. Both limits must hold. 512x512 and 4K are outside the supported range. This MaaS contract exposes size; do not send separate resolution or aspect_ratio fields.
Example
curl -X POST 'https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-flash/text-to-image' \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"input": {
"prompt": "A cinematic futuristic city street at dusk after light rain, neon signs in English and Japanese reflecting on wet pavement, a stylish young woman in a transparent umbrella walking past a ramen shop, soft volumetric fog, detailed storefronts, realistic lighting, ultra-detailed, vibrant colors, natural skin tones, sharp focus",
"output_format": "jpeg",
"size": "2048x2048"
}
}'
curl 'https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID' \
-H "Authorization: Bearer $API_KEY"
Response
Submission returns task_uuid and status. Poll with the same API key until completed or failed. Successful image URLs are in output.images; cost_credits is in credits and may reflect the precharge until settlement finishes. Use your own accessible input image URL for editing or decomposition. The example URL below is from the MaaS public model example.
Related models
z-image-spicy/text-to-image
Generate high-quality images from text with custom dimensions from 256 to 1536 pixels, intelligent prompt rewriting, and seed control for creative design and batch generation.
xAI Grok Imagine Image v2.0 Text to Image
xAI Grok Imagine Image V2.0 Text-to-Image generates high-quality images from text prompts, with configurable aspect ratio, resolution, and quality for creative visuals, social content, marketing assets, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Qwen Image 3.0 Pro Text to Image
Qwen Image 3.0 Pro is a professional-grade text-to-image model with superior quality and advanced prompt understanding. Up to 2k. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
ai/prefect-pony-xl
Prefect Pony XL delivers high-quality anime-style image generation for character art and illustrations. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
OpenAI GPT Image 2 Text-to-Image
OpenAI's GPT Image 2 Text-to-Image generates high-quality images from natural-language prompts. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
OpenAI GPT Image 2 Edit
OpenAI's GPT Image 2 Edit enables image editing from natural-language instructions with one or more reference images. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
OpenAI GPT Image 2.5 Sunburst Text-to-Image
High-fidelity image generation for detailed compositions and demanding production work, with up to 4K output.
OpenAI GPT Image 2.5 Flare Text-to-Image
Fast, balanced image generation from natural-language prompts, with up to 4K output.