Seedream 图片生成与编辑

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

请求方式

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

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

多图融合与组图：image 传 URL/Data URI 数组，并按需设置 sequential_image_generation。

size 使用模型支持的像素尺寸或 1K/2K/4K 档位；watermark 控制水印。

response_format=url 返回临时图片地址；收到后应立即下载。早期 Seedream 版本的公开资料提到 URL 约 24 小时有效，但 ByteDance-Seedream-5.0-pro 尚无独立有效期承诺，不要依赖固定时长。b64_json 返回 Base64。

示例里的 assets.example.com 和 BASE64_IMAGE_DATA 都是占位符，不能直接调用；请替换为自己的有效图片或完整 Data URI。

同步超时与计费

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

记录响应中的 Request ID、请求时间和请求参数摘要。

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

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

当前同步接口不会返回可供客户端继续查询的 task_id，Request ID 只用于日志核对或支持排查，不能直接查询或找回图片。调用方可把读取超时设置为 300 到 500 秒，但中间 CDN/网关仍可能更早结束无响应字节的连接；延长客户端超时不能突破中间层限制。

`stream` 边界

stream 是兼容请求字段，但目前没有确认 ByteDance-Seedream-5.0-pro 提供图片预览帧、首包时限、SSE 事件格式或结束事件的公开协议。只有响应 Content-Type 为 text/event-stream 且持续收到事件时，才能把它当作真正的流式响应。若服务链先等待完整 JSON，再由中转层包装成 SSE，stream=true 不会产生早期保活字节，也不能避免 CDN 的静默回源超时。调用方脚本自行分块输出同样不能改变服务端连接是否有数据。

已验证与待确认参数

ByteDance-Seedream-5.0-pro 已验证：prompt、size=1K/2K、response_format=url、watermark=false、stream=false。

对该模型仍待独立确认：stream=true、b64_json、image 编辑、多图融合、n、quality、sequential_image_generation 及 4K。字段出现在兼容 Schema 中不等于每个 Seedream 版本都支持。

实测耗时参考

同一测试环境中，2K 非流式文生图约 119 秒完成、记录 16,428 输出 Token，但客户端约 61.415 秒收到 504；1K 非流式文生图约 85 秒完成、记录 4,450 输出 Token。耗时和 Token 仅用于解释超时风险，不是性能或价格承诺；最终用量以账户消费日志为准。

application/json

图片生成结果。根据 response_format 读取 data[].url 或 data[].b64_json。usage 的字段组合会因渠道而变化，可能出现 completion_tokens=0 但 output_tokens 或 total_tokens 大于零；最终以账户消费日志为准。

Bodyapplication/json

示例

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` 边界

已验证与待确认参数

实测耗时参考

请求参数

请求示例代码

返回响应

Seedream 图片生成与编辑

请求方式#

同步超时与计费#

stream 边界#

已验证与待确认参数#

实测耗时参考#

请求参数

请求示例代码

返回响应

请求方式

同步超时与计费

`stream` 边界

已验证与待确认参数

实测耗时参考