Seedream 图片生成与编辑

使用 ByteDance-Seedream-* 模型调用 Seedream 图片生成与编辑。所有请求必须携带 Authorization: Bearer <API_KEY>；文档页面若未显示结构化鉴权配置，仍以此要求和接口实际返回为准。

模型映射与分辨率

本站当前提供 4 个 Seedream 模型名。ByteDance-Seedream-5.0 对应火山方舟官方 Seedream 5.0 Lite，不是 5.0 Pro；带 -pro 后缀的 ByteDance-Seedream-5.0-pro 才对应官方 Seedream 5.0 Pro。

本站模型名	对应官方模型	支持的分辨率档位	自定义尺寸总像素范围
`ByteDance-Seedream-4.0`	Seedream 4.0	`1K`、`2K`、`4K`	`921,600` 至 `16,777,216`
`ByteDance-Seedream-4.5`	Seedream 4.5	`2K`、`4K`	`3,686,400` 至 `16,777,216`
`ByteDance-Seedream-5.0`	Seedream 5.0 Lite	`2K`、`3K`、`4K`	`3,686,400` 至 `16,777,216`
`ByteDance-Seedream-5.0-pro`	Seedream 5.0 Pro	`1K`、`1.5K`、`2K`	`921,600` 至 `4,624,220`

表中档位和像素范围来自火山方舟图片生成 API。自定义宽高还必须满足宽高比 1/16 至 16，档位与自定义宽高两种方式不可混用。

分辨率档位不是固定宽高。模型会结合提示词中的横版、竖版、正方形或宽高比描述决定实际尺寸。

ByteDance-Seedream-5.0 的 4K 正方形文生图已实测返回 4096x4096 JPEG；ByteDance-Seedream-5.0-pro 的 2K、3:4 图生图已实测返回 1776x2368 JPEG。

ByteDance-Seedream-5.0-pro 官方不支持 3K 或 4K，不要因兼容 Schema 出现 size 字段就向该模型传这些档位。

请求方式

文生图：只传 prompt，不要传 image。

单图编辑：image 传可公开访问的 HTTP(S) 图片 URL，或 data:image/<图片格式>;base64,<Base64编码> 形式的 Data URI。MIME 类型必须小写，例如 image/png、image/jpeg。

ByteDance-Seedream-5.0-pro 已实测支持单个 JPEG Data URI 图生图；URL 输入和多图输入仍需分别验证。

多图融合与组图：兼容 Schema 允许 image 数组。官方仅为 Seedream 5.0 Lite、4.5 和 4.0列出 sequential_image_generation；5.0 Pro 不支持组图参数。

response_format=url 返回的图片地址会失效，收到后应立即下载，不要把临时 URL 当作长期存储。

示例里的 assets.example.com、<BASE64_IMAGE_DATA> 和 BASE64_IMAGE_DATA 都是占位符，不能直接调用。

`stream=true` 行为

火山官方为 Seedream 5.0 Lite、4.5 和 4.0列出原生流式输出能力，没有为 Seedream 5.0 Pro 列出该能力。本站兼容层已实测接受 ByteDance-Seedream-5.0-pro 和 ByteDance-Seedream-5.0 的 stream=true，成功响应为 Content-Type: text/event-stream，完成事件格式为：

event: image_generation.completed
data: {"type":"image_generation.completed","created_at":1786462838,"usage":{"output_tokens":16428},"url":"https://assets.example.com/generated/image-01.jpeg"}

data: [DONE]

流式 completed 事件的图片地址位于 JSON 顶层 url；非流式 JSON 才读取 data[0].url。

ByteDance-Seedream-5.0-pro 的 2K 图生图直到 126.871s 才收到首正文；ByteDance-Seedream-5.0 的 4K 文生图直到 55.693s 才收到首正文。两次在完成前都没有 partial 图片事件或 SSE 心跳。

因此当前链路表现仍是“生成完成后用 SSE 返回结果”，不是渐进式预览，也不能依赖 stream=true 刷新 CDN 静默计时。客户端应忽略未知事件，并以 [DONE] 结束读取。

Request ID、同步超时与计费

成功响应的 NewAPI 关联编号位于 X-Oneapi-Request-Id 响应头；CDN 自己生成的超时响应未必包含该头。

本接口当前按同步请求处理。图片可能在网关或客户端超时后继续生成并产生计费，因此 HTTP 502、504、524 或客户端超时只表示调用方没有收到最终响应，不代表生成失败。

当前同步接口不会返回可供客户端继续查询的 task_id，Request ID 只用于日志核对或支持排查，不能直接查询或找回图片。

调用方读取超时建议设置为 300 到 500 秒，但延长客户端超时不能突破中间层限制。

发生超时时：

记录 X-Oneapi-Request-Id（如有）、请求时间、模型和参数摘要。

先检查账户消费日志和服务端请求日志，等待原请求完成。

不要自动或立即重试；确认原请求没有完成后再人工决定是否重发，避免重复生成和重复计费。

已验证与待确认参数

ByteDance-Seedream-5.0-pro 已验证：prompt、size=1K/2K、response_format=url、watermark=false、本站兼容层 stream=false/true、n=1，以及单个 JPEG Data URI image 编辑。官方不支持 3K、4K、sequential_image_generation 或原生流式输出。

ByteDance-Seedream-5.0 已验证：prompt、size=4K、response_format=url、watermark=false、stream=true、n=1 的正方形文生图。

仍待独立确认：b64_json、HTTP(S) URL 图片输入、多图融合、n>1、quality，以及 4.0/4.5/5.0 Lite 的其他档位和组图参数。字段出现在兼容 Schema 中不等于每个 Seedream 版本都支持。

实测耗时参考

ByteDance-Seedream-5.0-pro，1K、stream=true 文生图：客户端约 103.146s 完成并取得图片。

ByteDance-Seedream-5.0-pro，长静默窗口下的 2K JPEG Data URI 图生图：客户端 126.894s 完成，图片为 1776x2368 JPEG；记录 16,428 completion tokens。

ByteDance-Seedream-5.0，4K 正方形文生图：客户端 55.727s 完成，图片为 4096x4096 JPEG；记录 65,536 completion tokens，本次历史费用为 CNY 0.244800。

上述耗时、Token 和费用只用于解释实测行为，不是性能或价格承诺；最终用量与费用以账户消费日志为准。

Seedream 5.0 Pro 2K 示例：

Seedream 5.0 Lite 4K 流式示例（-N 禁用 curl 输出缓冲）：

application/json

图片生成结果。stream=false 时从 JSON 的 data[].url 或 data[].b64_json 读取；stream=true 时按 SSE 读取 image_generation.completed 事件顶层 url，并在 data: [DONE] 后结束。usage 字段组合会因渠道而变化，最终以账户消费日志为准。

Headers

Body

示例

URL 返回Base64 返回

{
    "created": 1786400000,
    "data": [
        {
            "url": "https://assets.example.com/generated/image-01.png",
            "revised_prompt": ""
        }
    ],
    "usage": {
        "completion_tokens": 0,
        "output_tokens": 4450,
        "total_tokens": 4450
    }
}

Seedream 图片生成与编辑

模型映射与分辨率

请求方式

`stream=true` 行为

Request ID、同步超时与计费

已验证与待确认参数

实测耗时参考

请求参数

请求示例代码

返回响应

Seedream 图片生成与编辑

模型映射与分辨率#

请求方式#

stream=true 行为#

Request ID、同步超时与计费#

已验证与待确认参数#

实测耗时参考#

请求参数

请求示例代码

返回响应

模型映射与分辨率

请求方式

`stream=true` 行为

Request ID、同步超时与计费

已验证与待确认参数

实测耗时参考