name: seedream-image description: Generate and edit images using ByteDance Seedream models via Atlas Cloud API. Supports batch generation (up to 15), editing, typography, poster design. Use when user asks to "generate an image with Seedream" or "create a poster".

Seedream Image Skill

Overview

This project provides a CLI tool (seedream) for generating and editing images using ByteDance's Seedream models via the Atlas Cloud API.

Commands

Generate an image

seedream "your prompt here"

Edit an image

seedream "edit instructions" --mode edit --image ./source.png --strength 0.75

Edit with mask

seedream "replace area" --mode edit --image ./source.png --mask ./mask.png

Batch generate (up to 15 images)

seedream "prompt" --mode batch --count 5

NSFW generation

seedream "prompt" --nsfw

Model variants

• --model v5.0-lite (default) — Latest, fastest
• --model v4.5 — Previous generation
• --model v4 — Cost-effective

Common options

• --size WxH — Image dimensions (default: 1024x1024)
• --steps N — Inference steps (default: 25)
• --guidance N — Guidance scale (default: 5.0)
• --seed N — Random seed
• --output path — Custom output path
• --negative-prompt "text" — Negative prompt

Output

Images are saved to ./output/ directory by default.

Setup

Requires ATLAS_CLOUD_API_KEY in .env file.

Seedream Image Skill

An AI Agent Skill for generating and editing images using ByteDance's Seedream models via Atlas Cloud API.

Works with 15+ AI coding agents including Claude Code, Cursor, OpenAI Codex, GitHub Copilot, Gemini CLI, Windsurf, OpenCode, Kiro, and more.

Seedream is ByteDance's state-of-the-art image generation model family, renowned for its exceptional Chinese text rendering, typography, and poster design capabilities. This skill brings Seedream's power directly into your AI coding workflow.

Features

• Text-to-Image Generation — Generate stunning images from text prompts with industry-leading quality
• Image Editing — Edit existing images with text instructions, masks, and strength control
• Batch / Sequential Generation — Generate up to 15 related images in a single API call
• Typography & Poster Design — Best-in-class Chinese character rendering and layout
• NSFW-Capable — Whitelisted for unrestricted content generation on Atlas Cloud
• Multiple Model Variants — Choose the right model for your use case and budget
• Flexible Output — Control size, steps, guidance, seeds, and more

Model Variants

Prices shown are starting prices. Higher resolution or additional features may cost more.

Input Parameters

Text-to-Image (Generate Mode)

Image Editing (Edit Mode)

Sequential / Batch Mode

Why Seedream?

Best Chinese Text Rendering

Seedream is the undisputed leader in rendering Chinese characters within generated images. Whether you're creating posters, banners, social media graphics, or product mockups with Chinese typography, Seedream produces crisp, accurate, and beautifully styled text that other models simply cannot match.

Poster & Design Excellence

The Seedream model family has been specifically optimized for commercial design use cases:

• Magazine covers with perfect text placement
• Product posters with accurate brand typography
• Social media graphics with legible overlay text
• Event banners with complex multi-line layouts
• Marketing materials with mixed Chinese/English text

NSFW Whitelisted on Atlas Cloud

Atlas Cloud provides whitelisted access to Seedream's full capabilities, including NSFW content generation. This is ideal for:

• Adult content platforms
• Artistic nude photography generation
• Unrestricted creative exploration
• Content that other platforms would block

Sequential Generation

Need a series of related images? Seedream's sequential mode generates up to 15 coherent, thematically linked images in a single API call — perfect for:

• Storyboard creation
• Product angle variations
• Style exploration
• A/B testing visual concepts
• Comic or manga panel generation

Installation

Prerequisites

• Bun runtime installed
• An Atlas Cloud API key (get one here)

Setup

# Clone the repository
git clone https://github.com/thoughtincode/seedream-image-skill.git
cd seedream-image-skill

# Install dependencies
bun install

# Set up your API key
cp .env.example .env
# Edit .env and add your ATLAS_CLOUD_API_KEY

# Link the CLI globally
bun link

Verify Installation

seedream --help

Usage

Basic Text-to-Image

seedream "A majestic dragon flying over a mountain range at sunset"

Specify Model and Size

seedream "Cyberpunk cityscape at night" --model v4.5 --size 1280x720

Image Editing

seedream "Add a rainbow in the sky" --mode edit --image ./photo.png --strength 0.6

Edit with Mask

seedream "Replace with a red sports car" --mode edit --image ./scene.png --mask ./mask.png

Batch Generation

seedream "Cute cat in different poses" --mode batch --count 5

Sequential with Custom Parameters

seedream "Comic panels of a space adventure" --mode batch --count 8 --size 768x768 --steps 30

NSFW Mode

seedream "Artistic figure study, oil painting style" --nsfw

Full Parameter Control

seedream "A beautiful Japanese garden in autumn" \
  --model v5.0-lite \
  --size 1024x1024 \
  --steps 30 \
  --guidance 7.5 \
  --seed 42 \
  --output ./my-garden.png \
  --negative-prompt "blurry, low quality"

CLI Reference

seedream <prompt> [options]

Arguments:
  prompt                    Text description of the image to generate

Options:
  --model <variant>         Model variant: v5.0-lite (default), v4.5, v4
  --mode <mode>             Generation mode: generate (default), edit, batch
  --size <WxH>              Image dimensions (default: 1024x1024)
  --steps <n>               Inference steps (default: 25)
  --guidance <n>            Guidance scale (default: 5.0)
  --count <n>               Number of images for batch mode (default: 1, max: 15)
  --seed <n>                Random seed for reproducibility
  --output <path>           Output file path (default: ./output/<timestamp>.png)
  --image <path>            Source image for edit mode (file path or URL)
  --mask <path>             Mask image for edit mode (file path or URL)
  --strength <n>            Edit strength 0.0-1.0 (default: 0.75)
  --negative-prompt <text>  What to avoid in the generation
  --nsfw                    Enable NSFW content generation
  --help                    Show this help message

Agent Skill Integration

This tool is designed to work as an AI agent skill across all major coding agents. Install it with a single command:

npx skills add seedream-image-skill

This works with Claude Code, Cursor, OpenAI Codex, GitHub Copilot, Gemini CLI, Windsurf, OpenCode, Kiro, and any agent that supports skill installation.

Add to your project's CLAUDE.md

## Image Generation with Seedream

Use the `seedream` CLI to generate images:
- Basic: `seedream "your prompt here"`
- Edit: `seedream "edit instructions" --mode edit --image ./source.png`
- Batch: `seedream "prompt" --mode batch --count 5`
- NSFW: add `--nsfw` flag
- Models: v5.0-lite (default), v4.5, v4

How It Works

1. Your AI agent reads the skill instructions
2. When asked to generate images, the agent invokes the seedream CLI
3. The CLI sends requests to Atlas Cloud API
4. Images are downloaded and saved to the ./output directory
5. The agent can reference the saved images in subsequent interactions

API Details

Authentication

Set your Atlas Cloud API key in the .env file or as an environment variable:

export ATLAS_CLOUD_API_KEY=your_api_key_here

Endpoints