Seedream 4.0 API Tutorial: ByteDance Image Generation for Production Pipelines

import requests
import json
import base64

VOLC_ACCESS_KEY = "your-access-key"
VOLC_SECRET_KEY = "your-secret-key"

# Volcano Engine endpoint
endpoint = "https://visual.volcengineapi.com/v1/images/generations"

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {VOLC_ACCESS_KEY}"
}

response = requests.post(
    endpoint,
    headers=headers,
    json={
        "model": "seedream-4.0",
        "prompt": "A serene Japanese garden in autumn, koi pond with maple leaves "
                  "floating on water, stone lantern, morning mist, photorealistic",
        "size": "1024x1024",
        "n": 1,
        "quality": "hd"
    }
)

result = response.json()
image_url = result["data"][0]["url"]
print(f"Generated image: {image_url}")

from openai import OpenAI

client = OpenAI(
    api_key="your-crazyrouter-key",
    base_url="https://crazyrouter.com/v1"
)

# Use DALL-E compatible endpoint with Seedream model
response = client.images.generate(
    model="seedream-4.0",
    prompt="A futuristic Tokyo street at night, holographic advertisements, "
           "rain-slicked roads reflecting neon, cyberpunk aesthetic, 8K detail",
    size="1024x1024",
    n=1,
    quality="hd"
)

image_url = response.data[0].url
print(f"Image URL: {image_url}")

curl -X POST https://crazyrouter.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-crazyrouter-key" \
  -d '{
    "model": "seedream-4.0",
    "prompt": "Professional product photo of wireless earbuds on marble surface, soft studio lighting, minimalist composition",
    "size": "1024x1024",
    "n": 1,
    "quality": "hd"
  }'

[Subject] + [Details] + [Setting/Background] + [Style] + [Technical Specs]

"Minimalist flat lay of a leather wallet, car keys, and sunglasses on 
a white marble surface. Soft directional lighting from top-left. 
Shot on Phase One IQ4, f/8, product photography, commercial quality."

"Portrait of a female cyberpunk hacker, short neon-blue hair, 
augmented reality glasses, leather jacket with circuit patterns. 
Dark alley background with holographic signs. Digital art style, 
highly detailed, dramatic rim lighting."

"Modern minimalist house in a forest clearing, floor-to-ceiling 
glass walls, concrete and wood materials, infinity pool reflecting 
trees. Golden hour lighting, architectural photography, wide angle."

"一张中国风海报，标题写着'春节快乐'，红色灯笼，金色祥云，
传统剪纸风格边框，喜庆氛围，高清印刷品质"

response = requests.post(
    endpoint,
    headers=headers,
    json={
        "model": "seedream-4.0",
        "prompt": "Professional headshot of a business executive, "
                  "neutral background, studio lighting",
        "negative_prompt": "cartoon, anime, distorted, blurry, "
                          "watermark, text overlay, low quality",
        "size": "1024x1024",
        "n": 1
    }
)

import asyncio
import aiohttp

async def generate_batch(prompts, model="seedream-4.0"):
    """Generate multiple images concurrently."""
    async with aiohttp.ClientSession() as session:
        tasks = []
        for prompt in prompts:
            task = generate_single(session, prompt, model)
            tasks.append(task)

        # Limit concurrency to avoid rate limits
        semaphore = asyncio.Semaphore(5)

        async def limited_task(task):
            async with semaphore:
                return await task

        results = await asyncio.gather(*[limited_task(t) for t in tasks])
        return results

async def generate_single(session, prompt, model):
    """Generate a single image."""
    async with session.post(
        "https://crazyrouter.com/v1/images/generations",
        headers={
            "Authorization": "Bearer your-crazyrouter-key",
            "Content-Type": "application/json"
        },
        json={
            "model": model,
            "prompt": prompt,
            "size": "1024x1024",
            "n": 1
        }
    ) as resp:
        data = await resp.json()
        return data["data"][0]["url"]

# Generate product images for an e-commerce catalog
prompts = [
    "Product photo: red running shoes on white background, studio lighting",
    "Product photo: blue denim jacket folded neatly, white background",
    "Product photo: stainless steel water bottle, minimalist, white background",
    "Product photo: wireless headphones, matte black, white background",
    "Product photo: leather messenger bag, brown, white background",
]

urls = asyncio.run(generate_batch(prompts))
for i, url in enumerate(urls):
    print(f"Product {i+1}: {url}")

class MarketingImagePipeline:
    def __init__(self, api_key, base_url="https://crazyrouter.com/v1"):
        self.client = OpenAI(api_key=api_key, base_url=base_url)

    def generate_ad_set(self, product_name, style="modern"):
        """Generate a complete ad set: hero, social, banner."""
        sizes = {
            "hero": "1792x1024",      # Website hero
            "social_square": "1024x1024",  # Instagram
            "social_story": "1024x1792",   # Stories
        }

        results = {}
        for name, size in sizes.items():
            prompt = self._build_prompt(product_name, name, style)
            response = self.client.images.generate(
                model="seedream-4.0",
                prompt=prompt,
                size=size,
                n=1,
                quality="hd"
            )
            results[name] = response.data[0].url

        return results

    def _build_prompt(self, product, format_type, style):
        base = f"Professional advertisement for {product}, {style} aesthetic, "
        if format_type == "hero":
            return base + "wide composition, lifestyle context, aspirational mood"
        elif format_type == "social_square":
            return base + "centered composition, bold colors, social media optimized"
        elif format_type == "social_story":
            return base + "vertical composition, dynamic angle, mobile-first design"

# Usage
pipeline = MarketingImagePipeline("your-crazyrouter-key")
ad_set = pipeline.generate_ad_set("Premium Wireless Earbuds", style="minimalist tech")