Seedream Image
by @germey
Generate and edit AI images with Seedream (ByteDance) via AceDataCloud API. Use when creating images from text prompts, editing existing images with inpainti...
clawhub install acedatacloud-seedream-imageπ About This Skill
name: seedream-image description: Generate and edit AI images with Seedream (ByteDance) via AceDataCloud API. Use when creating images from text prompts, editing existing images with inpainting/outpainting, or working with ultra-high-resolution outputs. Supports Seedream 2.0, 2.1, 3.0, and 3.0 Turbo models. license: Apache-2.0 metadata: author: acedatacloud version: "1.0" compatibility: Requires ACEDATACLOUD_API_TOKEN environment variable. Optionally pair with mcp-seedream for tool-use.
Seedream Image Generation
Generate and edit AI images through AceDataCloud's Seedream (ByteDance) API.
Authentication
export ACEDATACLOUD_API_TOKEN="your-token-here"
Quick Start
curl -X POST https://api.acedata.cloud/seedream/images \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "a cyberpunk cat wearing VR goggles in a neon city", "model": "seedream-3.0"}'
Models
| Model | Resolution | Speed | Best For |
|-------|-----------|-------|----------|
| seedream-2.0 | Standard | Fast | Quick drafts |
| seedream-2.1 | Standard | Fast | Improved quality over 2.0 |
| seedream-3.0 | Up to 2048Γ2048 | Standard | High-quality generation (default) |
| seedream-3.0-turbo | Up to 2048Γ2048 | Faster | Speed-optimized with near-3.0 quality |
Workflows
1. Text-to-Image
POST /seedream/images
{
"prompt": "a serene Japanese garden with cherry blossoms and a red bridge",
"model": "seedream-3.0",
"width": 1024,
"height": 1024
}
2. Image Editing (Inpainting / Outpainting)
Edit regions of an existing image using a mask.
POST /seedream/images/edit
{
"prompt": "replace with a golden sunset sky",
"image_url": "https://example.com/photo.jpg",
"mask_url": "https://example.com/mask.png",
"model": "seedream-3.0"
}
Parameters
Generation
| Parameter | Values | Description |
|-----------|--------|-------------|
| model | "seedream-2.0", "seedream-2.1", "seedream-3.0", "seedream-3.0-turbo" | Model to use |
| width | 512 β 2048 | Image width in pixels |
| height | 512 β 2048 | Image height in pixels |
| seed | integer | Seed for reproducible results |
Editing
| Parameter | Required | Description |
|-----------|----------|-------------|
| image_url | Yes | URL of the source image to edit |
| mask_url | Yes | URL of the binary mask (white = edit region) |
| prompt | Yes | Describe what to place in the masked area |
MCP Server
pip install mcp-seedream
Or hosted: https://seedream.mcp.acedata.cloud/mcp
Key tools: seedream_generate_image, seedream_edit_image
Gotchas
seedream-3.0-turbo offers a good speed/quality trade-off for iterative workflowsimage_url and mask_urlπ‘ Examples
curl -X POST https://api.acedata.cloud/seedream/images \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "a cyberpunk cat wearing VR goggles in a neon city", "model": "seedream-3.0"}'