Doubao 图片接口

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

接口地址

POST https://www.moyu.info/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`(关闭)

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

响应字段说明

字段	类型	说明
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（推荐方式）#

其他语言#

响应格式#

请求参数#

响应字段说明#

完整示例#

生成高清艺术图片#

图片下载说明#

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

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

错误处理#

常见错误#

Windows 环境编码问题说明#

问题原因#

验证方法#

解决方案#

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

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

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