Seedream 生图/编辑

概述

Seedream 是字节跳动 BytePlus 火山方舟海外版的旗舰图像生成模型系列，统一生成-编辑架构：文生图、单图编辑、多图融合、批量序列生成都通过同一个 /v1/images/generations 端点完成，仅参数不同。API易与 BytePlus 达成官方战略合作，第一时间接入全部活跃版本。

🎨 核心亮点：三个活跃版本（5.0 / 4.5 / 4.0）统一计费 + 4K 高清出图 + 最多 10 张参考图融合 + 批处理 (输入+输出 ≤ 15 张) + 强中文文字渲染。适合电商主图、广告海报、产品摄影、内容创作 等需要高画质 + 文字渲染的生产场景。

文生图 API

POST /v1/images/generations，纯文本提示词生成图片，支持 1K/2K/3K/4K 与精确像素尺寸。

图片编辑 API

同端点 + image 参数，支持单图改图、多图融合、批量序列生成（最多 15 张）。

历史版本

5.0 / 4.5 / 4.0 三版本规格对比、价格差异、迁移指南。

为什么选 API易的 Seedream

对标 BytePlus 火山方舟海外版官方通道，针对企业生产场景在 稳定性、成本、接入体验 三方面做了深度优化：

官方战略合作 · 资源稳定

与 BytePlus 火山方舟达成官方合作，走授权直连链路，请求和响应行为与官方一致，无协议绕行风险，企业可放心走生产。

不限并发 · 企业可放量

批量出图、多图融合、序列生成等高并发场景下，可线性扩容，不受官方账号 Tier 限制。500 RPM 默认配额，更高量级可申请扩容。

同价 + 充值最高 8 折

默认单价与 BytePlus 官方一致，叠加充值加赠活动 最低可享 8 折，长期使用成本显著下降。

全球零门槛接入

无需海外服务器或代理，国内机房、家宽网络、海外节点均可直连 api.apiyi.com，省去为 BytePlus ap-southeast-1 / eu-west-1 配置出海链路的麻烦。

OpenAI 兼容 · 零代码改动

端点路径 /v1/images/generations 与 OpenAI 一致，OpenAI 官方 SDK 把 base_url 指过来即可调用，扩展参数（image / sequential_image_generation 等）通过 extra_body 透传。

专业服务 · 企业陪跑

团队深耕图像生成场景，在多图融合、文字渲染、批量素材生产等场景具备丰富经验，可为企业客户提供从 PoC 到生产上线的完整技术支持。

核心特性

4K 高保真出图

4.0 / 4.5 支持原生 4K（4096×4096），细节层次丰富，适合海报、印刷物料；5.0-lite 上限 3K，但综合体验更新。

统一生成-编辑架构

文生图 / 单图编辑 / 多图融合 / 序列批量都走 同一端点同一参数集，仅靠 image 与 sequential_image_generation 切换模式。

多图融合 · 最多 10 张参考图

image 字段接受 URL 数组，prompt 中可用「图1/图2」明确指代顺序，配合 sequential_image_generation: "disabled" 做主体一致性控制。

文字渲染突破

4.5 版本对小文本渲染大幅改进，海报标题、广告文案、产品文字等场景清晰可读，业界领先。

批量序列生成（最多 15 张）

sequential_image_generation: "auto" + max_images 一次生成成系列的连续图像，适合分镜、品牌视觉、产品系列图。

约 15 秒/张 · 速度均衡

单图典型耗时 15 秒左右，4K + hd 档稍长。500 RPM 默认配额，企业批量需求可申请扩容。

灵活尺寸 · 任意比例

支持分辨率档位（1K/2K/3K/4K）或精确像素，总像素范围 [1280×720, 4096×4096]，宽高比 [1/16, 16]。

OpenAI SDK 直连

base_url=https://api.apiyi.com/v1 即可用 OpenAI 官方 SDK 调用，扩展参数通过 extra_body 透传，零代码改动迁移。

模型定价

按张计费，与 BytePlus 官方同价，叠加充值加赠后实际成本进一步下降。

模型	API易价格	折扣前估算	状态
`seedream-5-0-260128`	$0.035/张	约￥0.245/张	✅ 当前推荐（最新）
`seedream-4-5-251128`	$0.04/张	约￥0.28/张	✅ 当前推荐
`seedream-4-0-250828`	$0.03/张	约￥0.21/张	🟡 维护中（仍可调用）

计费说明：

按出图张数计费，与 prompt 长度、是否走多图融合无关
sequential_image_generation: "auto" 模式下按实际生成张数计费（如 max_images: 4 出 4 张则计 4 次）
失败请求（4xx / 内容审核拦截）不计费
官方提供 200 张免费图片测试额度（首次接入即享）
充值加赠政策见充值加赠活动

技术规格

维度	seedream-5-0	seedream-4-5	seedream-4-0
Model ID	`seedream-5-0-260128`	`seedream-4-5-251128`	`seedream-4-0-250828`
Model ID 别名	`seedream-5-0-lite-260128`	—	—
上线日期	2026-01-28 (UTC+8)	2025-11-28 (UTC+8)	2025-08-28 (UTC+8)
支持分辨率档位	2K / 3K	2K / 4K	1K / 2K / 4K
输出格式	`png` / `jpeg`	`jpeg`	`jpeg`
Prompt 优化模式	standard	standard	standard / fast
文生图	✅	✅	✅
单图编辑	✅	✅	✅
多图参考融合	✅	✅（最多 10 张）	✅
批量序列生成	✅	✅	✅
流式输出	✅	✅	✅
每分钟最大出图（RPM）	500	500	500
单次输入+输出图数量	≤ 15	≤ 15	≤ 15
响应字段	`data[].url` 或 `data[].b64_json`	同	同

端点一览

端点	用途	Content-Type
`POST /v1/images/generations`	文生图 / 单图编辑 / 多图融合 / 批量序列 — 全部能力统一入口，靠请求体参数切换模式	`application/json`

域名选择：主域名 api.apiyi.com，也可使用 vip.apiyi.com 等其它网关域名，响应行为一致。不需要使用 BytePlus 原生的 ark.ap-southeast.bytepluses.com / ark.eu-west.bytepluses.com——API易网关已统一映射到 OpenAI 兼容路径。

关键参数详解

`size`（输出尺寸）

支持两类取值，二选一： 预设档位（按分辨率自动决定宽高比）：

档位	含义	模型支持
`1K`	约 1024×1024	仅 4.0
`2K`	约 2048×2048（默认）	5.0 / 4.5 / 4.0
`3K`	约 3072×3072	仅 5.0
`4K`	约 4096×4096	4.5 / 4.0

精确像素（自定义任意尺寸）：

总像素范围：[1280×720, 4096×4096]
宽高比范围：[1/16, 16]
默认值：2048x2048

合法示例：1920x1080（FullHD）、3840x2160（横版 4K）、1080x1920（手机壁纸）、2560x1440（横版 2K） 非法示例：5000x5000（超上限）、100x1600（比例超 1/16）

超过 4096×4096 总像素的尺寸会直接报 400。某些极端比例（接近 1/16 或 16）可能出现画面拉伸不稳定，建议优先用预设档位或常见 16:9 / 9:16 / 1:1 比例。

`image` 与 `sequential_image_generation`（编辑 / 多图 / 批量模式开关）

/v1/images/generations 端点同时承担文生图与编辑/多图能力，靠 两个参数组合 切换模式：

模式	`image` 参数	`sequential_image_generation`	说明
纯文生图	不传	不传或 `"disabled"`	输出 1 张
单图编辑	`["url1"]`	`"disabled"`	基于 1 张参考图改图
多图融合	`["url1", "url2", ...]`	`"disabled"`	最多 10 张参考图，prompt 用「图1/图2」指代
批量序列生成	可选（传或不传）	`"auto"` + `sequential_image_generation_options.max_images`	输出 N 张连贯图像，N ≤ max_images 且输入图 + 输出图 ≤ 15

详细代码示例见文生图 Playground 和图片编辑 Playground。

最佳实践

选对版本

追求最强综合体验 → seedream-5-0-260128（功能最全，但分辨率上限 3K）
要 4K 出图 + 强文字渲染 → seedream-4-5-251128（4K + 文字渲染突破）
要 4K + 性价比 → seedream-4-0-250828（最便宜的 4K）

尺寸优先选预设

1K/2K/3K/4K 档位经过官方优化，速度和质量更稳定。自定义像素留给真有比例需求的场景，注意各版本支持的档位不同。

多图融合时显式指代

传入 image 数组时，prompt 里用「把图1的人物放进图2的场景，沿用图3的色彩风格」明确顺序引用，避免模型自行猜测。

批量序列控制成本

sequential_image_generation: "auto" + max_images: 4 一次出 4 张，按张计费总价乘 4。先用 max_images: 1 验证 prompt，再放大批量。

输出格式按场景选

5.0 支持 png 与 jpeg，4.5 / 4.0 仅 jpeg。需要透明背景或无损细节时优先 5.0 + png，体积敏感的场景用 jpeg。

超时配置 ≥ 60 秒

单图约 15 秒，但批量序列（4 张）或 4K + hd 可能 30–60 秒。客户端超时建议 60 秒起步，前端做进度反馈。

水印按需关闭

watermark: false 关闭水印（默认行为视版本而定，建议显式传）。商用素材建议显式关，避免输出带 BytePlus 标识。

错误码与重试

状态码	含义	处理建议
`400`	参数非法（size 超限、`image` 数组超 10、未支持的分辨率档位等）	校验参数，注意各版本支持的分辨率档位差异
`401`	令牌无效	检查 Bearer Token
`403`	内容审核拦截	调整 prompt 或更换参考图
`429`	限流（默认 500 RPM）/ 余额不足	指数退避重试；超出 500 RPM 联系商务申请扩容
`5xx`	网关 / 后端错误	重试 1–2 次
超时	长尾请求	客户端超时 ≥ 60 秒（批量序列或 4K hd 可达 1 分钟）

建议客户端：

请求超时 60 秒 起步（批量序列或 4K hd 可能 1 分钟）
对 5xx 与超时做 指数退避重试（建议 2 次）
记录响应头 x-request-id 方便排查

常见问题

5.0 / 4.5 / 4.0 应该选哪个？

你的需求	推荐
最新功能 + 综合体验	`seedream-5-0-260128`
4K 高清 + 强文字渲染（海报、广告）	`seedream-4-5-251128`
4K 高清 + 最优性价比	`seedream-4-0-250828`
长期稳定大批量	`seedream-4-0-250828`（已验证）

详见历史版本对比。

为什么图片编辑也走 generations 端点？

Seedream 是统一生成-编辑架构，没有独立的 /v1/images/edits 端点。和 OpenAI 的 gpt-image-2 不同：OpenAI 的图编辑要 multipart/form-data 上传文件到 /v1/images/edits，Seedream 则统一用 application/json 把图片 URL 数组 传到 image 字段。优点：协议统一、参数复用、容易切换模式。详见图片编辑 Playground。

image 字段接受 base64 吗？

官方文档示例只展示了 URL 数组。如果你的图片在本地，建议先上传到 OSS / 公网图床拿到 URL 再传入。如需对接私有图床，可联系商务讨论临时签名 URL 方案。

多图融合最多几张？批量序列最多几张？

多图融合（image 数组）：4.5 官方明确”最多 10 张”，5.0 / 4.0 同样支持但官方未单独说明上限
批量序列（max_images）：受全局约束 输入参考图 + 输出图 ≤ 15。所以多图 + 序列同时用时要算总和。

返回的 b64_json 要不要自己加 data:image 前缀？

要看 response_format：

response_format: "url"（默认）→ 返回 data[0].url，直接 <img src=...> 渲染
response_format: "b64_json" → 返回 data[0].b64_json 纯 base64 字符串（不含 data:image/...;base64, 前缀），客户端需 base64.b64decode 写文件，或浏览器渲染时自行拼前缀

支持流式出图吗？

支持。三个版本都标注”Streaming output ✅“，配合 stream: true 启用。流式特别适合长 prompt + 高分辨率场景，前端可提前渲染部分结果。

速率限制是多少？

默认 500 张/分钟（Max Images per Minute），三个版本统一。如果业务需要更高配额，请联系商务告知预估 QPS，可申请扩容资源。

生成失败会扣费吗？

不会。BytePlus 自带内容安全审核，触发审核或参数非法时直接返回 400/403 错误并不计费。其它常见 0 计费错误：401（令牌无效）、429（限流）。只有请求实际进入模型生成阶段（200 + 有效响应）才按张计费。

可以用 OpenAI 官方 SDK 直连吗？

可以，零代码改动。把 base_url 指向 https://api.apiyi.com/v1，扩展参数（image / sequential_image_generation / watermark 等）通过 extra_body 透传：

from openai import OpenAI

client = OpenAI(api_key="sk-your-key", base_url="https://api.apiyi.com/v1")
resp = client.images.generate(
    model="seedream-5-0-260128",
    prompt="...",
    size="2K",
    extra_body={
        "image": ["https://.../ref.png"],
        "sequential_image_generation": "disabled",
        "watermark": False,
    }
)

生成的图片版权归谁？

通过 API 生成的图片，用户拥有完整的使用权，可用于商业和非商业用途。具体条款详见 BytePlus 服务协议。

支持透明背景吗？

seedream-5-0 支持 png 输出格式，可在 prompt 中要求”transparent background, alpha channel”得到带透明的图。seedream-4-5 / 4-0 仅 jpeg 输出，不支持透明背景，需自行后处理抠图。

主动取消生成任务可以吗？

不支持。/v1/images/generations 是同步端点，请求一旦提交会跑到结束。客户端即使断开连接，服务端仍会完整执行并照常计费。建议客户端做好超时控制，不要依赖”断连不计费”。

产品基础

基础 API

图片 API

视频 API

多模态理解 API

文本 API

概述

文生图 API

图片编辑 API

历史版本

为什么选 API易的 Seedream

官方战略合作 · 资源稳定

不限并发 · 企业可放量

同价 + 充值最高 8 折

全球零门槛接入

OpenAI 兼容 · 零代码改动

专业服务 · 企业陪跑

核心特性

4K 高保真出图

统一生成-编辑架构

多图融合 · 最多 10 张参考图

文字渲染突破

批量序列生成（最多 15 张）

约 15 秒/张 · 速度均衡

灵活尺寸 · 任意比例

OpenAI SDK 直连

模型定价

技术规格

端点一览

关键参数详解

`size`（输出尺寸）

`image` 与 `sequential_image_generation`（编辑 / 多图 / 批量模式开关）

最佳实践

错误码与重试

常见问题

相关文档

产品基础

基础 API

图片 API

视频 API

多模态理解 API

文本 API

​概述

文生图 API

图片编辑 API

历史版本

​为什么选 API易 的 Seedream

官方战略合作 · 资源稳定

不限并发 · 企业可放量

同价 + 充值最高 8 折

全球零门槛接入

OpenAI 兼容 · 零代码改动

专业服务 · 企业陪跑

​核心特性

4K 高保真出图

统一生成-编辑架构

多图融合 · 最多 10 张参考图

文字渲染突破

批量序列生成（最多 15 张）

约 15 秒/张 · 速度均衡

灵活尺寸 · 任意比例

OpenAI SDK 直连

​模型定价

​技术规格

​端点一览

​关键参数详解

​size（输出尺寸）

​image 与 sequential_image_generation（编辑 / 多图 / 批量模式开关）

​最佳实践

​错误码与重试

​常见问题

​相关文档

概述

为什么选 API易的 Seedream

核心特性

模型定价

技术规格

端点一览

关键参数详解

`size`（输出尺寸）

`image` 与 `sequential_image_generation`（编辑 / 多图 / 批量模式开关）

最佳实践

错误码与重试

常见问题

相关文档