功能与支持模型
三款模型均通过同一个 JSON 请求生成一张图片，支持文字、单参考图或多参考图。参数放在请求体顶层，不放在 metadata、parameters 或 extra_fields 中。
| 官方型号 | 本站模型ID | 尺寸档位 | 图片编码 | 本目录适用能力 |
|---|---|---|---|---|
| Seedream 5.0 Lite | doubao-seedream-5-0-260128 | 2K / 3K / 4K | jpeg / png | 文生、单图编辑、多参考图；单图SSE |
| Seedream 4.5 | doubao-seedream-4-5-251128 | 2K / 4K | jpeg | 文生、单图编辑、多参考图；单图SSE |
| Seedream 4.0 | doubao-seedream-4-0-250828 | 1K / 2K / 4K | jpeg | 文生、单图编辑、多参考图；单图SSE |
本站当前可见型号（2026-10-02）
下面是青云TOP API 公共目录快照，不等同于厂商官方型号清单。带-c、-preview、-t或尺寸后缀的名称按本站模型 ID 使用；是否可调用仍以你的 API Key 的GET /v1/models结果为准。
| 模型 ID | 可见协议 | 分组 |
|---|---|---|
doubao-seedream-3-0-t2i-250415 | openai | 国内模型 |
doubao-seedream-4-0-250828 | openai | 国内模型 |
doubao-seedream-4-5-251128 | openai | 国内模型 |
doubao-seedream-5-0-260128 | openai | 国内模型 |
第一步：设置鉴权
使用请求头 Authorization: Bearer YOUR_API_KEY。把 YOUR_API_KEY 替换为青云TOP API 的 API Key，保留 Bearer 后一个空格。
第二步：调用模型
使用 POST https://top.qingyuntop.ai/v1/images/generations，请求头为 Content-Type: application/json。完整三语言示例见文生图、单图编辑和多参考图。
请求参数
| 字段与类型 | 填写规则、默认值与限制 |
|---|---|
model；string | 必填；JSON 顶层。使用本目录模型表的完整 ID，没有推荐默认型号。5.0 Lite 的本站 ID 不带 lite 后缀。 |
prompt；string | 必填；JSON 顶层非空文本。说明主体、构图、风格和需要保留或修改的部分；多图可按数组顺序称图1、图2。支持中英文，建议中文不超过300字、英文不超过600词；这是写作建议，不是硬性长度上限。 |
image；string / string[] | 文生图省略；编辑或参考生图必填，位于 JSON 顶层。单张用字符串，多张用字符串数组（最多14张）。内容是公网可读 URL 或 data:image/小写格式;base64,内容。没有默认图片；不得传本地路径或裸 Base64。 |
size；string | 可选；JSON 顶层。默认2048x2048。填模型允许的分辨率档位或宽x高字符串；两种方式选一种。像素值用 ASCII x，同时满足下表的总像素和宽高比限制。 |
response_format；string | 可选；JSON 顶层。url 返回临时图片链接；b64_json 返回图片的纯 Base64 字符串。只改变返回方式，不改变图片编码。 默认 url。 |
output_format；string | 可选；JSON 顶层。仅本目录的5.0 Lite可设 png 或 jpeg。4.5、4.0输出JPEG，请省略此字段。请求PNG不等于支持透明背景。 默认 jpeg。 |
watermark；boolean | 可选；JSON 顶层布尔值。true 在右下角添加可见的“AI生成”水印，false 关闭该可见水印；不代表清除所有隐式标记。不要传字符串。 默认 true。 |
stream；boolean | 可选；JSON 顶层布尔值。false 等待完整JSON；true 消费SSE事件。本目录按单图请求使用，流式并非逐像素预览。 默认 false。 |
尺寸与模型组合
| 模型 | 默认宽高 | 自定义总像素范围 | 宽高比范围 |
|---|---|---|---|
| Seedream 5.0 Lite | 2048x2048 | 3686400–16777216 | 1/16–16 |
| Seedream 4.5 | 2048x2048 | 3686400–16777216 | 1/16–16 |
| Seedream 4.0 | 2048x2048 | 921600–16777216 | 1/16–16 |
总像素指宽乘高，不能只判断单边像素。size: "2K" 让模型结合提示词选择比例；需要明确宽高时使用如 "2048x2048" 的字符串。不要再增加独立 aspect_ratio 字段。
例如 3750x1250 的总像素为4687500、宽高比为3，满足三款型号的像素规则；1500x1500 总像素仅2250000，不满足5.0 Lite和4.5的最低要求。1024x1024 可用于4.0，但不能沿用到5.0 Lite或4.5。
参考图片限制
单张 image 是字符串，多张是字符串数组；本目录最多14张输入、1张输出。多图的顺序有意义，提示词中的“图1”“图2”按数组顺序对应。请明确每张素材负责人物、服装、风格还是背景。
每张参考图不超过30MB；宽、高均须大于14px，总像素为196–36000000，宽高比为1/16–16。支持 jpeg、png、webp、bmp、tiff、gif、heic、heif，常规接入推荐PNG或JPEG。限制适用于每张图片本身，不能只检查文件扩展名。
公网 URL 必须能由服务端直接获取，不能是登录后才能查看的网页、localhost 地址或本地文件路径。data URI 需包含小写 MIME 格式和 ;base64,，如 data:image/png;base64, 后紧跟真实编码。Base64 会增大 JSON 请求体，较大素材优先使用稳定的公网 URL。
容易混用的参数
response_format 选择 URL 或 Base64；output_format 选择图片编码，二者不同。5.0 Lite可以设PNG或JPEG；4.5、4.0请省略 output_format，按JPEG处理。不能从PNG输出推导透明背景支持。
本目录不使用 n 控制组图，不推荐 sequential_image_generation、sequential_image_generation_options、tools、optimize_prompt_options、layer_decomposition、background。也不要迁入旧型号的 seed、guidance_scale 或其他接口的 quality、mask、images 参数。
结果与排错
非流式检查 HTTP 状态、顶层 error、data[].error 和实际图片字段。开启流式后请按单图流式输出处理事件；保存文件见返回结果与图片保存。参数拒绝、素材失败和超时处理见常见错误。
参考：官方图像生成 API。