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.

Discovering and Leveraging the Seedream V3 Text-to-Image Model

Seedream V3 by ByteDance is a formidable tool in the realm of text-to-image AI, designed for swift, high-quality bilingual output. Whether you're a developer, creator, or executive at Segmind, understanding how to effectively utilize this model can significantly enhance your workflow and project outcomes.

Key Features and Benefits

Seedream V3 offers native 2K high-resolution image generation, producing crisp visuals suitable for everything from digital designs to large-scale prints. Developers can integrate Seedream V3 into applications via its REST API for seamless automation and on-demand image synthesis, supporting rapid innovation. Additionally, the model's speed—generating high-resolution images in a mere three seconds—facilitates real-time creative processes, beneficial for iterative design and rapid prototyping.

For creators, Seedream V3's robust prompt interpretation translates detailed natural language into vivid imagery. Its ability to embed text accurately, in both English and Chinese, makes it ideal for creating complex layouts, such as web banners and advertisements, with a high degree of precision.

Executives can leverage Seedream V3's business applications, such as improving marketing materials and engaging in cross-regional campaigns with ease, due to its bilingual capabilities.

Tips for Optimal Use

To achieve the best results with Seedream V3, be precise 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.