能做什么

本目录使用 Images JSON 接口：POST https://top.qingyuntop.ai/v1/images/generations。不传 image 时按文字生成图片；传一张图片时编辑原图；传图片数组时综合多张参考图生成一张结果。输入可以是公网 URL 或本地图片编码后的 data URI。

每次请求按一张输出图使用。文生图与图生图共用同一路径，不使用 /v1/images/edits、multipart 文件上传或厂商的 /api/v3 路径。返回 data[].url 或 data[].b64_json，也可以开启 SSE 等待图片完成。

支持模型与选择

官方型号本站模型ID尺寸档位图片编码本目录适用能力
Seedream 5.0 Litedoubao-seedream-5-0-2601282K / 3K / 4Kjpeg / png文生、单图编辑、多参考图；单图SSE
Seedream 4.5doubao-seedream-4-5-2511282K / 4Kjpeg文生、单图编辑、多参考图；单图SSE
Seedream 4.0doubao-seedream-4-0-2508281K / 2K / 4Kjpeg文生、单图编辑、多参考图；单图SSE

本站当前可见型号（2026-10-02）

下面是青云TOP API 公共目录快照，不等同于厂商官方型号清单。带 -c、-preview、-t 或尺寸后缀的名称按本站模型 ID 使用；是否可调用仍以你的 API Key 的 GET /v1/models 结果为准。
模型 ID可见协议分组
doubao-seedream-3-0-t2i-250415openai国内模型
doubao-seedream-4-0-250828openai国内模型
doubao-seedream-4-5-251128openai国内模型
doubao-seedream-5-0-260128openai国内模型

新接入优先从 Seedream 5.0 Lite 开始；需要沿用既有工作流时可选 4.5 或 4.0。模型是否可调用还取决于你的 API Key、分组权限和可用额度；模型列表中出现某个名称不等于你的账号已经有调用权限。

本站示例使用 doubao-seedream-5-0-260128，它是 Lite。官方还使用 doubao-seedream-5-0-lite-260128 这个名称，请不要直接用别名替换本站示例中的 ID。

5.0 Pro 与旧型号

官方已发布 Seedream 5.0 Pro（doubao-seedream-5-0-pro-260628），但本目录尚未确认该型号在本站开放，因此不提供它的本站调用示例。Pro 与 Lite 的尺寸、参考图数量和流式能力不同，不能只改模型名套用本目录代码。需要 Pro 时请先联系本站支持确认可用入口。

Seedream 3.0 已于 2026年5月11日14:00（UTC+8）进入官方下线阶段，SeedEdit 3.0 已于 2026年3月31日14:00（UTC+8）关停。新接入使用上表型号；不要依赖旧名称的自动替换行为。

第一步：设置鉴权

使用请求头 Authorization: Bearer YOUR_API_KEY。把 YOUR_API_KEY 替换为青云TOP API 的 API Key，保留 Bearer 后一个空格。

第二步：选择调用方式

需求入口与下一步
只提供文字文生图
修改一张图、读取本地图片单图编辑与本地图片
合成人物、服装或多张参考素材多参考图生图
通过事件接收完成结果单图流式输出
选择尺寸和返回格式参数与模型限制
下载 URL 或解码 Base64返回结果与图片保存

调用边界

本目录的调用方式按单图生成使用。暂不提供组图、联网搜索、提示词优化模式、图层拆分或透明背景的调用保证；不要通过增加 n、tools、sequential_image_generation 或 extra_fields 来扩展这些示例。需要这些能力时，先向本站支持确认对应入口和参数。

此流程不返回可轮询的任务 ID，不提供本目录对应的查询、取消或 webhook 步骤。请求超时或断线不代表生成已经取消，避免自动重新提交造成重复生成。

常见问题与参考

调用失败请先查看常见错误。模型能力和生命周期可参考火山引擎图像生成 API、Seedream 图像创作和模型下线通知；厂商入口使用其自身鉴权，本站调用以本目录为准。