🎨 Doubao 图片接口

Doubao (豆包) 图片生成接口文档。

接口地址

POST https://www.moyu.cn/v1/images/generations

请求示例

注意事项

⚠️ Windows 环境下 curl 中文编码问题

在 Windows 系统上使用 curl 的 -d 参数直接传递中文时，curl 会使用系统码页（GBK）而非 UTF-8 编码，导致中文 prompt 被错误理解。

推荐解决方案：

使用 --data-binary @文件 方式发送请求

或使用 Python/JavaScript/Go 等编程语言调用

cURL（推荐方式）

其他语言

响应格式

{
  "model": "doubao-seedream-4-5-251128",
  "created": 1770558368,
  "data": [
    {
      "url": "https://ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com/doubao-seedream-4-5/...",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16384,
    "total_tokens": 16384
  }
}

请求参数

参数	类型	必填	默认值	说明
model	string	是	-	模型名称，如 `doubao-seedream-4-5-251128`
prompt	string	是	-	图片描述提示词，详细描述想要生成的图片内容
size	string	否	2K	图片尺寸，如 `2K`、`2048x2048`、`2848x1600`
quality	string	否	standard	图片质量：`standard`(标准) 或 `hd`(高清)
sequential_image_generation	string	否	disabled	组图生成模式：`auto`(自动判断) 或 `disabled`(关闭)

完整参数列表请参考 豆包官方文档

高级参数（Seedream 进阶能力）

除基础生图参数外，Seedream 系列模型还支持以下进阶能力，直接在请求 body 中传入对应字段即可。各字段的模型支持范围不同，请按下表使用。

参数	类型	默认值	说明	支持模型
`layer_decomposition`	boolean	false	图层拆分开关。开启后将单张输入图拆解为 1 张底图 + 最多 16 个可独立编辑的图层，每个图层为带透明通道的 PNG	Seedream 5.0 pro
`sequential_image_generation`	string	disabled	组图模式：`auto`（模型自动判断是否生成一组关联图片）/ `disabled`（仅生成单图）	Seedream 5.0 lite / 4.5 / 4.0
`sequential_image_generation_options`	object	-	组图配置，仅在 `sequential_image_generation` 为 `auto` 时生效，如 `{"max_images": 4}`，取值范围 1~15	Seedream 5.0 lite / 4.5 / 4.0
`optimize_prompt_options`	object	-	提示词优化配置，如 `{"mode": "fast"}`；`standard` 质量更高、耗时较长，`fast` 耗时更短	Seedream 5.0 pro / lite
`tools`	array	-	工具配置，如 `[{"type": "web_search"}]` 开启联网搜索，提升生成图片的时效性	Seedream 5.0 lite
`output_format`	string	jpeg	输出图片格式：`png` / `jpeg`	Seedream 5.0 pro / lite
`background`	string	opaque	透明通道：`transparent`（透明背景）/ `opaque`（实体背景），仅图生图场景可用	Seedream 5.0 pro

图层拆分示例

开启图层拆分时需传入单张参考图（image），模型会返回底图与各图层的位置信息。

图层拆分场景下，响应 data 数组中每个图层会额外返回以下字段：

字段	类型	说明
`z_index`	integer	图层叠放顺序。底图固定为 0，图层从 1 开始递增，数值越大越靠上层
`name`	string	图层名称/标签，由模型根据拆分出的主体特征自动生成
`description`	string	图层的详细语义描述（颜色、状态、材质等）
`bounding_box`	object	图层边界框，含 `absolute`（绝对像素坐标 `[left, top, right, bottom]`）与 `normalized`（归一化坐标，范围 0~1000）

组图生成示例

说明：实际生成的图片数量除受 max_images 影响外，还受输入参考图数量限制——「输入参考图数量 + 最终生成图片数量 ≤ 15 张」。

响应字段说明

字段	类型	说明
model	string	使用的模型名称
created	integer	创建时间戳
data	array	生成的图片列表
data[].url	string	图片的URL地址，可直接访问下载（当 response_format 为 url 时）
data[].b64_json	string	Base64编码的图片数据（当 response_format 为 b64_json 时）
data[].size	string	图片实际尺寸，如 "2048x2048"
usage	object	使用情况统计
usage.generated_images	integer	生成的图片数量
usage.output_tokens	integer	输出token数（用于计费）
usage.total_tokens	integer	总token数

完整示例

生成高清艺术图片

图片下载说明

正常情况下，当 response_format 为 url 时，返回的图片链接可以直接在浏览器中打开访问和下载。如果遇到 URL 无法访问的情况，可通过以下两种方式获取图片。

方案一：使用 Base64 格式直接获取图片数据

将 response_format 改为 b64_json，API 会直接返回图片的 Base64 数据，无需访问外部 URL。

cURL + Python 解码保存：

Python 完整示例：

方案二：通过 curl 直接下载 URL

保持 response_format 为 url，获取到图片链接后，使用 curl 在服务端直接下载：

cURL：

Python：

错误处理

常见错误

尺寸不支持

{
  "error": {
    "message": "The parameter `size` specified in the request is not valid: image size must be at least 3686400 pixels",
    "type": "upstream_error",
    "param": "size",
    "code": "InvalidParameter"
  }
}

解决方案：使用至少 2K 分辨率的尺寸，如 2K、2048x2048 或 2848x1600

模型不存在

{
  "error": {
    "message": "The model specified does not exist",
    "type": "invalid_request_error",
    "param": "model",
    "code": "model_not_found"
  }
}

解决方案：检查模型名称是否正确，确保使用 doubao-seedream-4-5-251128

Windows 环境编码问题说明

问题原因

Windows 系统上 curl 的 -d 参数使用系统码页（GBK/CP936）编码中文，而非 UTF-8。这会导致：

中文 prompt 被错误理解，生成的图片可能不符合预期

prompt 中的中文字符被误解为其他含义

英文 prompt 正常工作

验证方法

使用 --trace 查看实际发送的字节：

如果看到中文字节是 GBK 编码（如 c4 e3 ba c3）而非 UTF-8（e4 bd a0 e5 a5 bd），则确认是编码问题。

解决方案

方案一：使用文件发送（推荐）

方案二：切换控制台编码

chcp 65001

然后再执行 curl 命令。

方案三：使用编程语言（推荐）

使用 Python、JavaScript、Go 等编程语言调用 API，这些语言默认使用 UTF-8 编码，不会出现编码问题。

接口地址#

请求示例#

注意事项#

cURL（推荐方式）#

其他语言#

响应格式#

请求参数#

高级参数（Seedream 进阶能力）#

图层拆分示例#

组图生成示例#

响应字段说明#

完整示例#

生成高清艺术图片#

图片下载说明#

方案一：使用 Base64 格式直接获取图片数据#

方案二：通过 curl 直接下载 URL#

错误处理#

常见错误#

Windows 环境编码问题说明#

问题原因#

验证方法#

解决方案#

方案一：使用文件发送（推荐）#

方案二：切换控制台编码#

方案三：使用编程语言（推荐）#