seedream-image

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Seedream Image Generation

Seedream图像生成

Generate and edit AI images through AceDataCloud's Seedream (ByteDance) API.

Setup: See authentication for token setup.

通过AceDataCloud的Seedream（字节跳动）API生成和编辑AI图像。

设置： 请查看身份验证了解令牌设置方法。

Quick Start

快速开始

bash

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": "doubao-seedream-5-0-260128"}'

Async: See async task polling. Poll via
POST /seedream/tasks
with
{"id": "..."}
.

bash

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": "doubao-seedream-5-0-260128"}'

异步处理： 请查看异步任务轮询。通过
POST /seedream/tasks
接口传入
{"id": "..."}
进行轮询。

Models

模型

Model	Version	Best For
`doubao-seedream-5-0-260128`	Seedream 5.0	Latest, highest quality (default)
`doubao-seedream-4-5-251128`	Seedream 4.5	High quality, balanced
`doubao-seedream-4-0-250828`	Seedream 4.0	Reliable generation
`doubao-seedream-3-0-t2i-250415`	Seedream 3.0 T2I	Text-to-image, precise prompt following
`doubao-seededit-3-0-i2i-250628`	SeedEdit 3.0	Image-to-image editing

模型	版本	适用场景
`doubao-seedream-5-0-260128`	Seedream 5.0	最新版本，画质最高（默认选项）
`doubao-seedream-4-5-251128`	Seedream 4.5	画质出色，表现均衡
`doubao-seedream-4-0-250828`	Seedream 4.0	生成效果稳定可靠
`doubao-seedream-3-0-t2i-250415`	Seedream 3.0 T2I	文本转图像，精准遵循提示词
`doubao-seededit-3-0-i2i-250628`	SeedEdit 3.0	图像转图像编辑

Workflows

工作流

1. Text-to-Image

1. 文本转图像

json

POST /seedream/images
{
  "prompt": "a serene Japanese garden with cherry blossoms and a red bridge",
  "model": "doubao-seedream-5-0-260128",
  "size": "1K"
}

json

POST /seedream/images
{
  "prompt": "a serene Japanese garden with cherry blossoms and a red bridge",
  "model": "doubao-seedream-5-0-260128",
  "size": "1K"
}

2. Image Editing (Image-to-Image)

2. 图像编辑（图像转图像）

Edit an existing image by providing the source image URL(s) and a descriptive prompt. Use the

doubao-seededit-3-0-i2i-250628

model for best editing results.

json

POST /seedream/images
{
  "prompt": "change the sky to a golden sunset",
  "model": "doubao-seededit-3-0-i2i-250628",
  "image": ["https://example.com/photo.jpg"]
}

通过提供源图像URL和描述性提示词来编辑现有图像。使用

doubao-seededit-3-0-i2i-250628

模型可获得最佳编辑效果。

json

POST /seedream/images
{
  "prompt": "change the sky to a golden sunset",
  "model": "doubao-seededit-3-0-i2i-250628",
  "image": ["https://example.com/photo.jpg"]
}

3. Async Generation with Task Polling

3. 异步生成与任务轮询

Pass a

callback_url

to receive results asynchronously via webhook, or poll

/seedream/tasks

for the result:

json

POST /seedream/images
{
  "prompt": "an epic fantasy landscape",
  "model": "doubao-seedream-5-0-260128",
  "callback_url": "https://api.acedata.cloud/health"
}

Poll the returned

task_id

json

POST /seedream/tasks
{"id": "<task_id>"}

传入

callback_url

通过Webhook异步接收结果，或轮询

/seedream/tasks

获取结果：

json

POST /seedream/images
{
  "prompt": "an epic fantasy landscape",
  "model": "doubao-seedream-5-0-260128",
  "callback_url": "https://api.acedata.cloud/health"
}

轮询返回的

task_id

：

json

POST /seedream/tasks
{"id": "<task_id>"}

Parameters

参数

Generation

生成参数

Parameter	Values	Description
`model`	see Models table	Model to use (required)
`prompt`	string	Image description (required)
`size`	`"1K"` , `"2K"` , `"3K"` , `"4K"` , `"adaptive"`	Output resolution (e.g. `1K` =1024px, `2K` =2048px); `3K` only for Seedream 5.0
`seed`	integer [-1, 2147483647]	Seed for reproducibility (Seedream 3.0 T2I / SeedEdit 3.0 only)
`guidance_scale`	number [1, 10]	Prompt adherence strength (3.0 models only; T2I default 2.5, edit default 5.5)
`sequential_image_generation`	`"auto"` , `"disabled"`	Generate related images in sequence (5.0, 4.5, 4.0 only)
`stream`	boolean	Stream images as they're generated (5.0, 4.5, 4.0 only)
`watermark`	boolean	Add AI-generated watermark (default: true)
`output_format`	`"jpeg"` , `"png"`	Output file format (Seedream 5.0 only; default: jpeg)
`response_format`	`"url"` , `"b64_json"`	Response format (default: url)
`tools`	array	Enable tools, e.g. `[{"type": "web_search"}]` (Seedream 5.0 only)
`callback_url`	string	Webhook URL for async delivery; returns `task_id` immediately

参数	可选值	说明
`model`	参考模型表格	使用的模型（必填）
`prompt`	字符串	图像描述（必填）
`size`	`"1K"` , `"2K"` , `"3K"` , `"4K"` , `"adaptive"`	输出分辨率（例如 `1K` =1024px， `2K` =2048px）；仅Seedream 5.0支持 `3K`
`seed`	整数 [-1, 2147483647]	用于生成结果可复现的种子值（仅Seedream 3.0 T2I / SeedEdit 3.0支持）
`guidance_scale`	数值 [1, 10]	提示词遵循强度（仅3.0系列模型支持；文本转图像默认值2.5，编辑默认值5.5）
`sequential_image_generation`	`"auto"` , `"disabled"`	按顺序生成关联图像（仅5.0、4.5、4.0版本支持）
`stream`	布尔值	生成图像时流式返回（仅5.0、4.5、4.0版本支持）
`watermark`	布尔值	添加AI生成水印（默认：开启）
`output_format`	`"jpeg"` , `"png"`	输出文件格式（仅Seedream 5.0支持；默认：jpeg）
`response_format`	`"url"` , `"b64_json"`	返回格式（默认：url）
`tools`	数组	启用工具，例如 `[{"type": "web_search"}]` （仅Seedream 5.0支持）
`callback_url`	字符串	用于异步交付结果的Webhook URL；会立即返回 `task_id`

Editing

编辑参数

Parameter	Required	Description
`image`	Yes (for editing)	Array of image URLs or base64 strings (max 10MB each)
`prompt`	Yes	Describe the desired edit

参数	是否必填	说明
`image`	是（编辑场景）	图像URL或base64字符串数组（单个文件最大10MB）
`prompt`	是	描述期望的编辑效果

Gotchas

注意事项

Model names now use the
```
doubao-*
```
naming convention (e.g.
```
doubao-seedream-5-0-260128
```
)
Image editing uses the same
```
/seedream/images
```
endpoint with the
```
image
```
array parameter (no separate edit endpoint)
```
size
```
replaces separate
```
width
```
/
```
height
```
params; use
```
"1K"
```
for 1024×1024,
```
"2K"
```
for 2048×2048, etc.
```
3K
```
size is only supported by Seedream 5.0;
```
adaptive
```
selects the best aspect ratio automatically

seed

only works with

doubao-seedream-3-0-t2i-250415

and

doubao-seededit-3-0-i2i-250628

```
guidance_scale
```
is only available for the 3.0-series models
```
stream
```
and
```
sequential_image_generation
```
are only available for Seedream 5.0, 4.5, and 4.0
Pass
```
callback_url
```
to get a
```
task_id
```
immediately and avoid blocking; poll
```
/seedream/tasks
```
for the result — use
```
"https://api.acedata.cloud/health"
```
as a placeholder to force async mode without a real webhook

MCP:
pip install mcp-seedream
| Hosted:
https://seedream.mcp.acedata.cloud/mcp
| See all MCP servers

模型名称现在采用
```
doubao-*
```
命名规范（例如
```
doubao-seedream-5-0-260128
```
）
图像编辑使用同一个
```
/seedream/images
```
接口，只需传入
```
image
```
数组参数（无单独的编辑接口）
```
size
```
参数替代了原有的
```
width
```
/
```
height
```
参数；
```
"1K"
```
对应1024×1024，
```
"2K"
```
对应2048×2048，以此类推
```
3K
```
分辨率仅支持Seedream 5.0；
```
"adaptive"
```
会自动选择最佳宽高比

seed

仅对

doubao-seedream-3-0-t2i-250415

和

doubao-seededit-3-0-i2i-250628

生效

```
guidance_scale
```
仅适用于3.0系列模型
```
stream
```
和
```
sequential_image_generation
```
仅支持Seedream 5.0、4.5和4.0版本
传入
```
callback_url
```
可立即获取
```
task_id
```
并避免阻塞；轮询
```
/seedream/tasks
```
获取结果 — 可使用
```
"https://api.acedata.cloud/health"
```
作为占位符，强制开启异步模式无需真实Webhook

MCP：
pip install mcp-seedream
| 托管地址：
https://seedream.mcp.acedata.cloud/mcp
| 查看所有MCP服务器