POST
javascript
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 const axios = require('axios'); const api_key = "YOUR API-KEY"; const url = "https://api.segmind.com/v1/seedream-v3-text-to-image"; const data = { "aspect_ratio": "16:9", "prompt": "A flourishing zen garden with cherry blossoms next to a calm koi pond, under a moonlit sky.", "seed": 12345, "guidance_scale": 2.5 }; (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


aspect_ratioenum:str *

Aspect ratio dictates the image dimensions. Use 16:9 for widescreen or 1:1 for square images.

Allowed values:


promptstr *

Briefly describe your desired scene. Be specific for best results, like 'sunset city skyline with neon lights'.


seedint ( default: 1 )

Input seed ensures consistent results. Keep consistent for replicable art or change for new variations.

min : 1,

max : 999999


guidance_scalefloat ( default: 2.5 ) Affects Pricing

Guidance scale affects adherence to the prompt. Higher numbers increase prompt influence, up to 10.

min : 1,

max : 10

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.

About Seedream V3, Text to Image model from ByteDance

Last updated: 14 Aug, 2025 by Rohit

The latest version of Bytedance's SeeDream is a major improvement over its previous version and other leading image generator models out there. It is in the legaue of GPT Image 1, Qwen Image and Imagen 4. Not only has the image quality leapfroged, the text rendering capabilties has also imporoved by a large margin. Let us deep dive into the key updates for this model.

Key Features and Benefits

The model generates images at upto 2K resolution, making it an ideal choice for high fidelity use cases. The outputs are crisp and can be upscaled using ESRGAN or other image upscalers to make them print and digital screen ready. The speed of generation has also improved, letting you generate super high quality images within 10 seconds.

The model's prompt understanding has also improved. It can now create complex layouts like banners with a high degree of precision. It can follow the prompts accurately to generate detailed vivid imagery. The model also has enhanced aesthetics and structural quality in it's outputs.

The bigges leap is in it's ability to generate accurate small text and long text strings. The race began when GPT Image showed long text being rendered accurately, and now with this model, the user has another image generator model option to generate long text accurately.

All of these updates are reflected in multiple evaluations and rankings, making one of the top contenders of best overall image generators out there in the market.

Tips for Optimal Use

To get the best results, be specific with your prompts, focusing on specific descriptors for commercial or multi-object scenes. Explore variations and test different phrasing to enhance visual outcomes quickly, thanks to its swift output speed. Consider using external tools for further post-processing to meet the specific aesthetic requirements of your projects.

In summary, Seedream V3 combines speed, resolution, and multilingual capabilities to accommodate diverse creative demands, making it a valuable asset in any AI-driven visual content strategy.