Seedream 5.0 — AI Image Generation & Editing by ByteDance

Other

Generate and edit AI images using ByteDance's Seedream — featuring text-to-image, image editing, and batch sequential generation with up to 4K resolution, PNG output, typography/poster design excellence, and built-in prompt optimization. Supports Seedream v5.0 Lite (latest), v4.5, and v4 across 3 generations and 12 model variants. Available via Atlas Cloud API at up to 10% off standard pricing. Use this skill whenever the user wants to generate images, edit photos, create posters, design typography, batch generate related images, create AI art, or mentions Seedream, ByteDance image, Jimeng, or Doubao image generation. Also trigger when users ask to create product photos, marketing visuals, brand assets, social media graphics, illustrations, concept art, batch image series, or any visual content using AI.

Install

openclaw skills install seedream

Seedream — AI Image Generation & Editing by ByteDance

Generate and edit AI images using ByteDance's Seedream — featuring text-to-image generation, image editing, and batch sequential generation across 3 model generations.

Seedream v5.0 Lite is the latest flagship model with enhanced quality, typography excellence, poster design capabilities, PNG output support, and built-in prompt optimization (Standard/Fast modes). It supports up to 4K resolution with 16 preset sizes and can process up to 14 reference images for editing.

Data usage note: This skill sends text prompts and image URLs to the Atlas Cloud API (api.atlascloud.ai) for image generation and editing. No data is stored locally beyond the downloaded output files. API usage incurs charges per image based on the model selected.

Key Capabilities

Text-to-Image — Generate images from text descriptions, up to 4K resolution
Image Editing — Edit images while preserving facial features, lighting, and color tones (up to 14 reference images)
Batch Sequential Generation — Generate up to 15 related images in a single request
Batch Sequential Editing — Edit multiple images in batch while maintaining consistency
Typography & Poster Design — Excels at text rendering in images, poster layouts, and brand visuals
Prompt Optimization — Built-in Standard (higher quality) and Fast (quicker) prompt optimization modes
PNG Output — Supports both JPEG and PNG output formats (v5.0 Lite)
16 Preset Resolutions — From 2K to 4K tier: 2048×2048, 2304×1728, 4096×2304, 4704×2016, and more
3 Generations — v5.0 Lite (latest), v4.5, v4

Setup

Sign up at https://www.atlascloud.ai
Console → API Keys → Create new key
Set env: export ATLASCLOUD_API_KEY="your-key"

The API key is tied to your Atlas Cloud account and its pay-as-you-go balance. All usage is billed to this account. Atlas Cloud does not currently support scoped keys — the key grants access to all models available on your account.

Script Usage

This skill includes a Python script for image generation. Zero external dependencies required.

List available image models

python scripts/generate_image.py list-models

Generate an image

python scripts/generate_image.py generate \
  --model "MODEL_ID" \
  --prompt "Your prompt here" \
  --output ./output

Upload a local image (for editing)

python scripts/generate_image.py upload ./local-image.jpg

Edit an image

python scripts/generate_image.py generate \
  --model "MODEL_ID" \
  --prompt "Edit instruction" \
  --image "https://...uploaded-url..."

Run python scripts/generate_image.py generate --help for all options. Extra model params can be passed as key=value (e.g. aspect_ratio=16:9 resolution=2k).

Pricing

All prices are per image generated. Atlas Cloud offers up to 10% off compared to standard API pricing.

Seedream v5.0 Lite

Model	Original Price	Atlas Cloud	Type
`bytedance/seedream-v5.0-lite`	~~$0.035~~	$0.032	Text-to-Image
`bytedance/seedream-v5.0-lite/edit`	~~$0.035~~	$0.032	Image Editing
`bytedance/seedream-v5.0-lite/sequential`	~~$0.035~~	$0.032	Batch Text-to-Image
`bytedance/seedream-v5.0-lite/edit-sequential`	~~$0.035~~	$0.032	Batch Image Editing

Seedream v4.5

Model	Atlas Cloud	Type
`bytedance/seedream-v4.5`	$0.036	Text-to-Image
`bytedance/seedream-v4.5/edit`	$0.036	Image Editing
`bytedance/seedream-v4.5/sequential`	$0.036	Batch Text-to-Image
`bytedance/seedream-v4.5/edit-sequential`	$0.036	Batch Image Editing

Seedream v4

Model	Atlas Cloud	Type
`bytedance/seedream-v4`	$0.024	Text-to-Image
`bytedance/seedream-v4/edit`	$0.024	Image Editing
`bytedance/seedream-v4/sequential`	$0.024	Batch Text-to-Image
`bytedance/seedream-v4/edit-sequential`	$0.024	Batch Image Editing

Standard API pricing sourced from fal.ai/seedream-5.0. Seedream v5.0 Lite generates images at ~2-3 seconds per image, making it one of the fastest high-quality image models available.

Parameters

Text-to-Image (v5.0 Lite)

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	Image description (recommended: under 600 English words)
`size`	string	No	2048*2048	Output size in WIDTH*HEIGHT pixels (see Size Options below)
`output_format`	string	No	jpeg	Output format: "jpeg" or "png"
`optimize_prompt_options`	object	No	-	Prompt optimization: Standard (higher quality) or Fast mode
`enable_base64_output`	boolean	No	false	Return Base64 instead of URL

Image Editing (v5.0 Lite)

Same as text-to-image, plus:

Parameter	Type	Required	Default	Description
`images`	array	Yes	-	Images to edit: URLs or Base64 (max 14, formats: JPEG/PNG/WEBP/BMP/TIFF/GIF)

Batch Sequential (v5.0 Lite)

Same as text-to-image / image editing, plus:

Parameter	Type	Required	Default	Description
`max_images`	integer	No	1	Number of images to generate (1-15, total with input must not exceed 15)

Text-to-Image (v4.5 / v4)

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	Image description
`size`	string	No	2048*2048	Output size in WIDTH*HEIGHT pixels
`enable_base64_output`	boolean	No	false	Return Base64 instead of URL

Size Options (v5.0 Lite — 16 presets)

2K Tier: 2048*2048, 2304*1728, 1728*2304, 2848*1600, 1600*2848, 2496*1664, 1664*2496, 3136*1344

3K+ Tier: 3072*3072, 3456*2592, 2592*3456, 4096*2304, 2304*4096, 2496*3744, 3744*2496, 4704*2016

Workflow: Submit → Poll → Download

Text-to-Image Example (v5.0 Lite)

# Step 1: Submit
curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateImage" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-v5.0-lite",
    "prompt": "A minimalist Japanese-style poster for a tea ceremony, elegant typography, zen garden background, warm earth tones",
    "size": "2304*4096",
    "output_format": "png"
  }'
# Returns: { "code": 200, "data": { "id": "prediction-id" } }

# Step 2: Poll (every 3 seconds, typically completes in 2-3s)
curl -s "https://api.atlascloud.ai/api/v1/model/prediction/{prediction-id}" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
# Returns: { "code": 200, "data": { "status": "completed", "outputs": ["https://...image-url..."] } }

# Step 3: Download
curl -o output.png "IMAGE_URL_FROM_OUTPUTS"

Image Editing Example (v5.0 Lite)

curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateImage" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-v5.0-lite/edit",
    "prompt": "Change the background to a sunset beach scene, keep the person unchanged",
    "images": ["https://example.com/photo.jpg"],
    "size": "2304*1728",
    "output_format": "jpeg"
  }'

Batch Sequential Example (v5.0 Lite)

curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateImage" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-v5.0-lite/sequential",
    "prompt": "A series of product photos for a coffee brand: latte art, espresso close-up, coffee beans, packaging design",
    "size": "2048*2048",
    "max_images": 4,
    "output_format": "jpeg"
  }'
# Returns multiple images in outputs array

Batch Sequential Editing Example

curl -s -X POST "https://api.atlascloud.ai/api/v1/model/generateImage" \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-v5.0-lite/edit-sequential",
    "prompt": "Apply a warm vintage film filter, slightly desaturated with golden highlights",
    "images": ["https://example.com/photo1.jpg", "https://example.com/photo2.jpg", "https://example.com/photo3.jpg"],
    "max_images": 3,
    "output_format": "jpeg"
  }'

Polling Logic

processing / starting → wait 3s, retry (typically takes 2-3s for single image)
completed / succeeded → done, get URL(s) from data.outputs[]
failed → error, read data.error

Atlas Cloud MCP Tools (if available)

If the Atlas Cloud MCP server is configured, use built-in tools:

atlas_generate_image(model="bytedance/seedream-v5.0-lite", params={...})
atlas_get_prediction(prediction_id="...")

Implementation Guide

Determine task type:
- Text-to-image: user describes what they want to generate
- Image editing: user provides existing image(s) and describes modifications
- Batch sequential: user needs multiple related images in one go
- Batch sequential editing: user needs consistent edits across multiple images
Choose model version:
- v5.0 Lite (recommended): Best quality, typography, PNG support, prompt optimization
- v4.5: Strong alternative with poster/brand design focus
- v4: Budget option at $0.024/image
Choose single vs sequential:
- Single: One image per request (default)
- Sequential: Up to 15 related images per request — ideal for product series, storyboards, brand asset sets
Extract parameters:
- Prompt: be descriptive about style, composition, colors, typography if needed
- Size: pick from 16 presets; consider aspect ratio (portrait/landscape/square/ultrawide)
- Output format: PNG for transparency or lossless, JPEG for smaller files
- Prompt optimization: Standard for best quality, Fast for speed
Execute: POST to generateImage API → poll prediction → download
Present result: show file path, display image if possible

Prompt Tips

Seedream produces excellent results especially for:

Typography & Text: "A poster with bold title 'SPRING SALE' in elegant serif font, floral frame..."
Poster Design: "Movie poster for a sci-fi thriller, dark blue tones, futuristic cityscape..."
Brand Visuals: "Product packaging design for organic tea brand, minimalist, earth tones..."
Multi-reference Editing: Provide multiple reference images for consistent style transfer
Batch Series: Use sequential mode for "A 4-panel comic strip..." or "Product photos from 4 angles..."

Model Comparison

Feature	v5.0 Lite	v4.5	v4
Price	$0.032	$0.036	$0.024
Max Resolution	4K+ (4704×2016)	4K (4096×4096)	4K (4096×4096)
PNG Output	Yes	No	No
Prompt Optimization	Standard/Fast	No	No
Typography Quality	Best	Excellent	Good
Speed	~2-3s	~3-5s	~3-5s
Batch Sequential	Up to 15	Up to 15	Up to 15
Max Reference Images	14	14	14