Seedream 3.0 t2i

Seedream V3 generates high-resolution, bilingual images in seconds, enhancing creative workflows and marketing effectiveness.


API

If you're looking for an API, you can choose from your desired programming language.

POST
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 import requests import base64 # Use this function to convert an image file from the filesystem to base64 def image_file_to_base64(image_path): with open(image_path, 'rb') as f: image_data = f.read() return base64.b64encode(image_data).decode('utf-8') # Use this function to fetch an image from a URL and convert it to base64 def image_url_to_base64(image_url): response = requests.get(image_url) image_data = response.content return base64.b64encode(image_data).decode('utf-8') # Use this function to convert a list of image URLs to base64 def image_urls_to_base64(image_urls): return [image_url_to_base64(url) for url in image_urls] api_key = "YOUR_API_KEY" url = "https://api.segmind.com/v1/seedream-v3-text-to-image" # Request payload 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 } headers = {'x-api-key': api_key} response = requests.post(url, json=data, headers=headers) print(response.content) # The response is the generated image
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.

Resources to get you started

Everything you need to know to get the most out of Seedream 3.0 t2i

Guide to Using Seedream V3 Effectively

Seedream V3 by ByteDance is a high-performance bilingual text-to-image model delivering crisp 2K visuals in seconds. This guide walks you through best practices and parameter settings to maximize creative control across various use cases.

1. Getting Started

  1. •API Integration
    • Use the REST endpoint to send JSON payloads.
    • Authenticate via your API key, then post prompt, aspect_ratio, and optional parameters.
  2. •Prompt Crafting
    • Be specific: include subjects, style keywords, lighting, mood.
    • Leverage English and Chinese terms to unlock cultural nuances.

2. Key Parameters & Recommendations

ParameterDescription & Tips
promptNatural language scene description. E.g. “serene mountain lake at dawn with misty pines.”
aspect_ratioChoose based on output format:
  • •16:9: Landscape wallpapers, presentations
  • •1:1: Social media posts (Instagram, product shots)
  • •9:16: Mobile stories, vertical posters | | seed | Integer (1–999999).
  • •Fixed seed: repeatable outputs for A/B tests.
  • •Random or omitted: unique variations for brainstorming. | | guidance_scale | Controls fidelity to prompt (1–10).
  • •1–3: creative freedom, looser interpretation.
  • •4–6 (default 2.5–5): balanced detail and creativity.
  • •7–10: strict adherence—ideal for commercial assets. |

3. Use Case Parameter Sets

  1. •Concept Art & Exploration
    • •aspect_ratio: 16:9
    • •guidance_scale: 2.0
    • •seed: omit or random
    • •prompt: “futuristic city skyline, neon reflections, heavy rain”
  2. •Marketing Banners
    • •aspect_ratio: 1:1 or 4:3
    • •guidance_scale: 8.0
    • •seed: fixed (e.g., 54321)
    • •prompt: “luxury skincare flatlay on marble, soft morning light”
  3. •Mobile Story Graphics
    • •aspect_ratio: 9:16
    • •guidance_scale: 5.0
    • •seed: random for variety
    • •prompt: “vibrant festival crowd, confetti, sunset hues, overhead drone view”

4. Advanced Tips

  • •Batch Generation: Loop through seeds to create image grids for client review.
  • •Post-Processing: Use external editors (Photoshop, Lightroom) for color grading or compositing.
  • •Variation Testing: Tweak synonyms, add artistic modifiers (e.g., “oil painting”, “cyberpunk”), and compare results side by side.

By fine-tuning prompts and parameters, Seedream V3 can adapt from free-form ideation to polished marketing collateral. Experiment with guidance scales and aspect ratios to find your sweet spot—unlocking high-quality, bilingual visuals in mere seconds.

Other Popular Models

Discover other models you might be interested in.

Cookie settings

We use cookies to enhance your browsing experience, analyze site traffic, and personalize content. By clicking "Accept all", you consent to our use of cookies.