POST
javascript
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 const axios = require('axios'); const api_key = "YOUR API-KEY"; const url = "https://api.segmind.com/v1/seedream-v5-lite-text-to-image"; const data = { "prompt": "A futuristic cityscape with flying cars at dusk", "aspect_ratio": "16:9", "size": "2K", "max_images": 1, "optimize_prompt": "standard", "watermark": false }; (async function() { try { const response = await axios.post(url, data, { headers: { 'x-api-key': api_key } }); console.log(response.data); } catch (error) { console.error('Error:', error.response.data); } })();
RESPONSE
image/jpeg
HTTP Response Codes
200 - OKImage Generated
401 - UnauthorizedUser authentication failed
404 - Not FoundThe requested URL does not exist
405 - Method Not AllowedThe requested HTTP method is not allowed
406 - Not AcceptableNot enough credits
500 - Server ErrorServer had some issue with processing

Attributes


promptstr *

Describe the image to create with subject and setting.


aspect_ratioenum:str ( default: 16:9 )

Width-to-height ratio. 16:9 for panoramic, 1:1 for square.

Allowed values:


sizeenum:str ( default: 2K )

Output resolution. 2K for standard use, 3K for sharpness.

Allowed values:


max_imagesint ( default: 1 ) Affects Pricing

Number of images to generate. Up to 15 for variations.

min : 1,

max : 15


optimize_promptenum:str ( default: standard )

Select prompt speed. 'Standard' for accuracy, 'Fast' for quicker outputs.

Allowed values:


watermarkboolean ( default: 1 )

Toggle watermark. Use 'true' to embed copyright or 'false' for no watermarking.

To keep track of your credit usage, you can inspect the response headers of each API call. The x-remaining-credits property will indicate the number of remaining credits in your account. Ensure you monitor this value to avoid any disruptions in your API usage.

Seedream 5.0 Lite: Text-to-Image Model

What is Seedream 5.0 Lite?

Seedream 5.0 Lite is a unified multimodal AI model for text-to-image generation built to follow instructions closely and produce high-detail visuals across many styles. It’s optimized for strong prompt understanding and composition control—useful when you need the model to “reason” about layout, objects, and stylistic constraints instead of producing generic images.

Seedream 5.0 Lite supports a wide range of outputs, from hand-drawn illustration and graphic poster designs to photorealistic composites. It’s a solid choice for developers integrating an image generation API into creative tools, content pipelines, and design workflows where prompt adherence and repeatable quality matter.

Key Features

  • High prompt fidelity: Better instruction following for subjects, attributes, and scene layout.
  • High-detail rendering: Produces crisp textures and defined edges, especially at higher resolutions.
  • Multi-style control: Switch between illustration, editorial, cinematic, and photorealistic looks.
  • Flexible framing: Built-in aspect_ratio presets for social, web, and video-friendly crops.
  • Variation batching: Generate up to 15 images per request via max_images.
  • Latency control: optimize_prompt supports standard (accuracy) or fast (speed).

Best Use Cases

  • Marketing and creative: ad concepts, hero banners, thumbnails, product storytelling
  • Design teams: moodboards, style explorations, layout drafts, brand-aligned visuals
  • Publishing: editorial illustration, covers, infographics-style artwork
  • E-commerce and product: photoreal mockups, lifestyle composites, backgrounds
  • Media and entertainment: concept art, cinematic stills, scene ideation

Prompt Tips and Output Quality

  • Lead with subject + action + environment, then add style + lighting + camera details.
    Example: “A cyclist riding through neon rain, Tokyo alley, cinematic lighting, 35mm, shallow depth of field.”
  • Specify composition: “centered subject,” “rule of thirds,” “wide shot,” “top-down.”
  • Use aspect_ratio intentionally: 9:16 for mobile stories, 16:9 for banners, 1:1 for grids.
  • Pick resolution with size: 2K for general use; 3K when you need sharper typography-like edges and fine textures.
  • Use max_images for exploration (e.g., 4–8 variations), then rerun the best prompt at 3K.

FAQs

Is Seedream 5.0 Lite open-source?
No public open-source release is specified; treat it as a hosted generative model.

How is it different from other text-to-image models?
It emphasizes instruction following, layout control, and consistent detail across diverse art styles.

What parameters should I tweak first?
Start with aspect_ratio, then size, then max_images. Use optimize_prompt=standard for best fidelity.

How do I get faster generations?
Set optimize_prompt to fast and keep max_images low (e.g., 1–2).

Can I generate multiple variations in one call?
Yes—set max_images from 1 up to 15 to batch outputs for A/B testing and creative exploration.