Doubao Seedream 5.0 图片生成接口文档

本文档适用于平台已接入的 Doubao Seedream 5.0 图片生成模型：

• doubao-seedream-5-0-pro-260628

接口采用 OpenAI 风格的请求地址、鉴权方式和基础 JSON 结构，但不等同于完整 OpenAI Images API。请以本文档列出的参数和限制为准。

---

1. 接口信息

POST https://api.openfde.work/v1/images/generations

请求头：

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json

---

2. 支持模型

模型名	说明	参考图数量	尺寸注意事项
doubao-seedream-5-0-pro-260628	Pro 版，画质、复杂指令理解、文字渲染能力更强	单图传 1 张；多图传 2～10 张	已实测支持 1024x1024、2048x2048、2K

---

3. 请求参数

字段	类型	必填	说明
model	string	是	模型名称，填写上方支持的模型名
prompt	string	是	图片生成描述，支持中文和英文
size	string	否	输出图片尺寸，例如 1024x1024、2048x2048、2K
image	string 或 string[]	否	参考图。单图传图片 URL 或 base64 data URL 字符串；多图传字符串数组。Pro 最多 10 张
watermark	boolean	否	是否添加平台水印，默认建议 false
response_format	string	否	返回格式：url 或 b64_json
output_format	string	否	输出格式：建议 png 或 jpeg；不要使用 webp

---

4. 尺寸规则

模型	推荐尺寸	说明
Pro	1024x1024、2048x2048、2K	2K 可用

---

5. 文生图

文生图不需要传 image。

curl --location "https://api.openfde.work/v1/images/generations" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "冬日清晨的东京街头，暖色路灯，电影感，高细节，真实摄影风格",
    "size": "1024x1024",
    "watermark": false
  }'

---

6. 参考图生图

图生图时，通过 image 字段传入一张或多张参考图。

支持以下形式：

• 单张图片 URL："https://example.com/reference.jpg"
• 单张 base64 data URL："data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."
• 多张参考图数组：["https://example.com/reference-1.jpg", "https://example.com/reference-2.jpg"]

多张参考图可以使用图片 URL、base64 data URL，或在同一个数组中混合使用两种形式。数组中的每一项都必须是有效的字符串。

参考图数量限制

模型	单参考图	多参考图	单次请求最多参考图
doubao-seedream-5-0-pro-260628	1 张	2～10 张	10 张

单张 URL 参考图

{
  "model": "doubao-seedream-5-0-pro-260628",
  "prompt": "保持人物五官不变，把背景换成海边日落，整体偏电影感",
  "size": "1024x1024",
  "image": "https://example.com/reference.jpg",
  "watermark": false
}

单张 base64 参考图

{
  "model": "doubao-seedream-5-0-pro-260628",
  "prompt": "保持主体不变，改成水彩插画风格",
  "size": "2048x2048",
  "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...",
  "watermark": false
}

多张 URL 参考图

{
  "model": "doubao-seedream-5-0-pro-260628",
  "prompt": "参考第一张图的人物形象和第二张图的服装设计，生成一张电影感全身人像",
  "size": "2048x2048",
  "image": [
    "https://example.com/person.jpg",
    "https://example.com/outfit.jpg"
  ],
  "watermark": false
}

多张混合格式参考图

{
  "model": "doubao-seedream-5-0-pro-260628",
  "prompt": "保留第一张图的主体，参考第二张图的构图和第三张图的色彩风格",
  "size": "2048x2048",
  "image": [
    "https://example.com/subject.jpg",
    "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...",
    "https://example.com/color-style.png"
  ],
  "watermark": false
}

---

7. 返回格式

默认返回 URL。指定 response_format 可控制返回图片形式。

URL 响应

请求：

{
  "model": "doubao-seedream-5-0-pro-260628",
  "prompt": "生成一张白底产品图",
  "size": "1024x1024",
  "response_format": "url",
  "watermark": false
}

响应：

{
  "data": [
    {
      "url": "https://example.com/generated-image.jpeg",
      "size": "1024x1024",
      "output_format": "jpeg"
    }
  ],
  "usage": {
    "generated_images": 1,
    "total_tokens": 4096
  }
}

base64 响应

请求：

{
  "model": "doubao-seedream-5-0-pro-260628",
  "prompt": "生成一张白底产品图",
  "size": "1024x1024",
  "response_format": "b64_json",
  "watermark": false
}

响应：

{
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...",
      "size": "1024x1024",
      "output_format": "jpeg"
    }
  ]
}

---

8 输出格式

可通过 output_format 指定输出格式。

参数值	实测结果
png	Pro 可请求
jpeg	Pro 可请求
webp	Pro 实测返回 InvalidParameter，不要使用

webp 错误示例：

{
  "error": {
    "message": "The parameter `output_format` specified in the request are not valid: must be one of: jpeg, png.",
    "code": "InvalidParameter",
    "param": "output_format"
  }
}

---

9. 常见错误

状态码	错误	原因	处理建议
400	InvalidParameter	output_format=webp	改用 png 或 jpeg
400	InvalidParameter	文生图传 background=transparent	不传 background，或只在单参考图场景下验证使用
401 / 403	鉴权失败	API Key 错误、过期或无模型权限、余额不足	检查 Key 和模型权限 、账户余额
413	请求体过大	base64 参考图过大	压缩图片或使用单张图片 URL
429	限流或额度不足	请求过快或余额不足	稍后重试或检查账户额度

---

10. 安全建议

• API Key 等同账号凭证，不要提交到代码仓库。
• 服务端调用接口，不要把 API Key 写入前端代码。
• 对外示例统一使用 YOUR_API_KEY，不要放真实密钥。
• 生产环境建议设置请求超时、错误重试和用量记录。