Skip to main content
POST
/
v1
/
images
/
generations
curl -s https://api.deerapi.com/v1/images/generations \
  -H "Authorization: Bearer $DEERAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "充满活力的特写编辑肖像,模特眼神犀利,头戴雕塑感帽子,色彩拼接丰富,眼部焦点锐利,景深较浅,具有 Vogue 杂志封面的美学风格,采用中画幅拍摄,工作室灯光效果强烈。",
    "size": "2K",
    "response_format": "url",
    "output_format": "png",
    "watermark": false
  }' | jq -r '.data[].url'
{
  "created": 1773296874,
  "data": [
    {
      "url": "https://ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com/example/output.jpeg"
    }
  ],
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 15552,
    "output_tokens": 15552,
    "prompt_tokens_details": {
      "cached_tokens_details": {}
    },
    "completion_tokens_details": {},
    "claude_cache_creation_5_m_tokens": 0,
    "claude_cache_creation_1_h_tokens": 0
  }
}
把当前页理解成 DeerAPI 的“同步图片结果入口”。如果你要的是异步任务对象,而不是直接拿图片,别从这里开始。

你可能想做的是哪一种生成

纯文生图

只传 modelpromptsize,最快看到第一张图。

参考图生成

增加 image,就可以从单张或多张参考图继续生成。

一次返回多张组图

直接传 n 最省心;要和火山方舟原生参数对齐时,再改用 sequential_image_generation

单图编辑

如果你的目标是“改一张现有图片”,不要绕回来写生成逻辑,直接改用 Seededit。

第一次调用最稳的顺序

1

先跑纯文生图

第一次建议直接用 doubao-seedream-5-0-260128promptsize=2K 这组最小参数。
2

先用 url 返回

response_format=url 最适合快速调试。等你确认链路没问题,再考虑 b64_json
3

再加参考图或组图

文生图跑通之后,再逐步加 imagentools 这些增强能力。
参考图最多 14 张,同时还要满足“输入参考图数量 + 最终生成图片数量小于等于 15”。

返回的图片 URL 直接访问报 AccessDenied?

返回的 url 是火山方舟对象存储的签名链接,包含 & 等特殊字符
如果你直接把原始 JSON 里的 URL 复制到浏览器或脚本里,可能因为 shell 转义、终端截断等原因丢失签名参数,导致类似下面的报错:
{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"}
解决方法:
  • curl:加 | jq -r '.data[].url' 单独提取 URL,不要手动复制 JSON 原文。
  • Python:用 result.data[0].urlimage["url"] 拿到的就是完整字符串,直接传给 requests.get()webbrowser.open() 即可。
  • JavaScript:同理用 result.data[0].url
  • 通用:确保 URL 里的 &% 等字符没有被截断或二次转义。

哪种情况别用当前页

  • 你要的是单图编辑,而不是重新生成,改看 Seededit
  • 你要的是带 idstatusquery 的异步任务工作流,改看 FLUX 或 Replicate 风格页面。

参考文档

Authorizations

Authorization
string
header
required

使用 DeerAPI Key 进行 Bearer Token 鉴权。

Body

application/json
model
enum<string>
required

当前已接入的 Seedream 模型 ID。

Available options:
doubao-seedream-4-0-250828,
doubao-seedream-4-5-251128,
doubao-seedream-5-0-260128
prompt
string
required

用于描述图像内容的提示词。建议先写清主体、动作、场景,再补充风格与光线。

image

可选参考图。支持单张字符串,或多张字符串数组。每项都可以是可公开访问的 URL,或 data:image/<format>;base64,<BASE64_IMAGE_DATA> 形式的数据 URL。

size
string

输出尺寸。doubao-seedream-5-0-260128 支持 2K3K 或自定义像素尺寸;doubao-seedream-4-5-251128 支持 2K4Kdoubao-seedream-4-0-250828 支持 1K2K4K

response_format
enum<string>
default:url

图片返回方式。url 返回下载链接,b64_json 返回 Base64 字符串。

Available options:
url,
b64_json
output_format
enum<string>

图片文件格式。仅 doubao-seedream-5-0-260128 支持自定义,可选 jpegpng

Available options:
jpeg,
png
watermark
boolean
default:true

是否添加 AI 生成水印。

sequential_image_generation
enum<string>
default:disabled

官方组图开关。auto 表示允许模型返回一组关联图片,disabled 表示只生成单张。

Available options:
auto,
disabled
sequential_image_generation_options
object

组图配置,仅在 sequential_image_generation=auto 时生效。

stream
boolean
default:false

是否开启流式输出。仅 Seedream 4.0 / 4.5 / 5.0 支持。

tools
object[]

模型工具列表。当前仅 doubao-seedream-5-0-260128 支持 web_search

optimize_prompt_options
object

提示词优化配置。fast 仅建议用于 doubao-seedream-4-0-250828

Response

200 - application/json

生成成功

created
integer
required

Unix 时间戳,单位为秒。

data
object[]
required
usage
object
required

DeerAPI 当前返回的用量统计。不同供应商的透传字段可能略有差异。

model
string

部分上游会返回实际使用的模型 ID。

error
object

请求级错误对象。