DeerAPI Seedream 图像生成接口文档:通过 POST /v1/images/generations 调用豆包 Seedream 4.0、4.5、5.0 进行文生图、图生图和组图生成,适合第一次接入 DeerAPI 的用户快速开始。
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
}
}model、prompt 和 size,最快看到第一张图。image,就可以从单张或多张参考图继续生成。n 最省心;要和火山方舟原生参数对齐时,再改用 sequential_image_generation。url 是火山方舟对象存储的签名链接,包含 & 等特殊字符。{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"}
| jq -r '.data[].url' 单独提取 URL,不要手动复制 JSON 原文。result.data[0].url 或 image["url"] 拿到的就是完整字符串,直接传给 requests.get() 或 webbrowser.open() 即可。result.data[0].url。&、% 等字符没有被截断或二次转义。id、status、query 的异步任务工作流,改看 FLUX 或 Replicate 风格页面。使用 DeerAPI Key 进行 Bearer Token 鉴权。
当前已接入的 Seedream 模型 ID。
doubao-seedream-4-0-250828, doubao-seedream-4-5-251128, doubao-seedream-5-0-260128 用于描述图像内容的提示词。建议先写清主体、动作、场景,再补充风格与光线。
可选参考图。支持单张字符串,或多张字符串数组。每项都可以是可公开访问的 URL,或 data:image/<format>;base64,<BASE64_IMAGE_DATA> 形式的数据 URL。
输出尺寸。doubao-seedream-5-0-260128 支持 2K、3K 或自定义像素尺寸;doubao-seedream-4-5-251128 支持 2K、4K;doubao-seedream-4-0-250828 支持 1K、2K、4K。
图片返回方式。url 返回下载链接,b64_json 返回 Base64 字符串。
url, b64_json 图片文件格式。仅 doubao-seedream-5-0-260128 支持自定义,可选 jpeg 或 png。
jpeg, png 是否添加 AI 生成水印。
官方组图开关。auto 表示允许模型返回一组关联图片,disabled 表示只生成单张。
auto, disabled 组图配置,仅在 sequential_image_generation=auto 时生效。
Show child attributes
是否开启流式输出。仅 Seedream 4.0 / 4.5 / 5.0 支持。
模型工具列表。当前仅 doubao-seedream-5-0-260128 支持 web_search。
Show child attributes
提示词优化配置。fast 仅建议用于 doubao-seedream-4-0-250828。
Show child attributes
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
}
}