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

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

Editing

MCP Server

pip install mcp-seedream

Or hosted: https://seedream.mcp.acedata.cloud/mcp

Key tools: seedream_generate_image, seedream_edit_image

Gotchas

• Maximum resolution is 2048×2048 — exceed this and requests fail
• Mask images must be binary (black/white) with the same dimensions as the source image
• seedream-3.0-turbo offers a good speed/quality trade-off for iterative workflows
• Results return a direct image URL — no task polling needed for generation
• Editing always requires both image_url and mask_url