Seedream V5.0 Pro Text to Image API

doubao/seedream-v5.0-pro/text-to-image

Seedream V5.0 Pro Text to Image by ByteDance generates high-quality images from text prompts, with aspect ratio selection, strong prompt following, and 1K / 2K output tiers for flexible image creation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Examples

Seedream V5.0 Pro Text to Image API Examples 1
Seedream V5.0 Pro Text to Image API Examples 2
Seedream V5.0 Pro Text to Image API Examples 3

Parameters

NameTypeDefaultConstraintsDescription
prompt *Prompttextarea—≤ 5000 charsThe positive prompt for the generation.
resolution *Resolutionselect1k1k | 2kThe output resolution tier used for billing. 1k is the lower-cost tier; 2k is the higher-cost tier.
aspect_ratioAspect Ratioselect1:11:1 | 1:2 | 2:1 | 1:3 | 3:1 | 2:3 | 3:2 | 3:4 | …The aspect ratio of the generated image.
output_formatOutput Formatselect—jpeg | pngThe format of the output image.

Output fields

FieldTypeDescription
imagesarray<string>Generated image URL(s).

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-pro/text-to-image" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "A cinematic portrait of a young astronaut standing in a lush bioluminescent forest at dusk, soft blue and purple lighting, intricate space suit details, floating particles in the air, ultra-realistic, highly detailed, atmospheric depth, sharp focus",
    "resolution": "2k",
    "aspect_ratio": "4:5",
    "output_format": "png"
  }
}'

# 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-pro/text-to-image",
    headers=HEADERS,
    json={
        "input": {
            "prompt": "A cinematic portrait of a young astronaut standing in a lush bioluminescent forest at dusk, soft blue and purple lighting, intricate space suit details, floating particles in the air, ultra-realistic, highly detailed, atmospheric depth, sharp focus",
            "resolution": "2k",
            "aspect_ratio": "4:5",
            "output_format": "png"
        }
    },
)
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-pro/text-to-image", {
  method: "POST",
  headers: { ...HEADERS, "Content-Type": "application/json" },
  body: JSON.stringify({
    "input": {
      "prompt": "A cinematic portrait of a young astronaut standing in a lush bioluminescent forest at dusk, soft blue and purple lighting, intricate space suit details, floating particles in the air, ultra-realistic, highly detailed, atmospheric depth, sharp focus",
      "resolution": "2k",
      "aspect_ratio": "4:5",
      "output_format": "png"
    }
  }),
});
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 V5.0 Pro Text to Image API

High-quality text-to-image generation with strong prompt adherence, flexible aspect ratios, and no cold starts.

Seedream V5.0 Pro is ByteDance’s advanced text-to-image model for developers and teams that need polished visual output with efficient production workflows. It combines strong prompt following, flexible aspect ratio support, 1K and 2K output tiers, and reliable no-cold-start performance for cost-effective image generation at scale.

🚀 Key Features

  • Pro-grade image quality: Built for high-quality text-to-image generation suitable for creative, marketing, and production use.
  • Strong prompt adherence: Accurately follows subject, scene, style, lighting, and composition instructions for more predictable results.
  • Flexible aspect ratios: Supports square, portrait, landscape, tall, and ultrawide layouts for a wide range of publishing formats.
  • Simple resolution tiers: Choose 1k for lower-cost iteration or 2k for higher-resolution final outputs.
  • Standard output formats: Export generated images in jpeg or png depending on workflow needs.
  • No cold starts: Designed for responsive, ready-to-run generation in production environments.

🛠️ Technical Specifications

ItemDetails
Model NameSeedream V5.0 Pro
Model IDbytedance/seedream-v5.0-pro
Task TypeText-to-image
Model ArchitectureAdvanced ByteDance text-to-image model
InputText prompt
OutputSingle image
Output Formatjpeg, png
Aspect Ratio1:1, 1:2, 2:1, 1:3, 3:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 9:21, 21:9
Resolution1k, 2k
Default Aspect Ratio1:1
Default Resolution1k
Default Output Formatjpeg
Latency ProfileNo cold starts; optimized for responsive generation
Typical WorkflowWrite prompt → choose aspect ratio → choose resolution → choose output format → generate image

Sample Prompts

  • Luxury skincare product shot on a marble surface, soft side lighting, minimal background, premium commercial photography, crisp details, elegant composition
  • Futuristic city street at night after rain, neon reflections, cinematic wide-angle composition, blue and purple color palette, ultra-detailed
  • Original anime-style character design sheet, full-body front view, clean background, intricate costume details, vibrant illustration style

💰 Pricing

ResolutionPrice
1k$0.045
2k$0.090

💡 Best Use Cases

  • Marketing creatives: Generate campaign visuals, social media graphics, promotional assets, and branded content.
  • Creative concepting: Explore characters, environments, products, and visual directions from natural language prompts.
  • E-commerce and brand production: Create layout-specific product visuals, banners, and merchandising assets efficiently.
  • Production image workflows: Use 1k for rapid prompt iteration and 2k for higher-resolution final delivery.

🔗 Related Models

  • Seedream V5.0 Pro Edit: A related model for text-guided image editing workflows.
  • Seedream V5.0 Lite: A lighter-weight alternative for users prioritizing efficiency and lower-cost generation.

Related models

z-image-spicy/text-to-image
Text to ImageZ Image Spicy

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.

from $0.014 / per run
xAI Grok Imagine Image v2.0 Text to Image
Text to ImageX Ai

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.

from $0.080 / per run
Qwen Image 3.0 Pro Text to Image
Text to ImageQwen Image 3.0 Pro

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.

from $0.0638 / per run
ai/prefect-pony-xl
Text to ImagePrefect Pony Xl

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.

from $0.015 / per run
OpenAI GPT Image 2 Text-to-Image
Text to ImageOpenAI

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.

from $0.660 / per run
OpenAI GPT Image 2 Edit
Text to ImageOpenAI

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.

from $0.660 / per run
OpenAI GPT Image 2.5 Sunburst Text-to-Image
Text to ImageOpenAI

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.

from $0.220 / per run
OpenAI GPT Image 2.5 Flare Text-to-Image
Text to ImageOpenAI

OpenAI GPT Image 2.5 Flare Text-to-Image

Fast, balanced image generation from natural-language prompts, with up to 4K output.

from $0.220 / per run