Seedream 5.0 走 OpenAI 兼容图片接口,可文生图,也可传入参考图继续生成。模型 ID 固定为 seedream-5.0
耗时较长、批量并发或需要可靠轮询时,也可以使用异步任务:
不要使用 POST /v1/images/edits。参考图请放在生成接口的 imageimages 字段中。

接入信息

调用前先用 /v1/models 确认当前 API Key 能看到 seedream-5.0

价格

按张计费。一次请求只生成一张图。1K 与 2K 价格不同: 以控制台模型广场当前价格为准。

画面规格

分辨率 resolution1k2k,默认 1k。参数值使用小写 k。本模型不提供 4K 档位,请不要传 4k 比例 size:默认 auto,由模型根据提示词或参考图判断;固定版式请明确填写比例。本模型的 size 填写画面比例,例如 16:9,不要写成 1024x1024 可选比例: auto1:13:22:34:33:45:44:516:99:162:11:23:11:321:99:21 参考图:建议不超过 4 张;images 最多 10 项。只接受公网可直接下载的图片 URL。 生成张数 n:只允许 1,或不传(默认 1)。一次请求只生成一张图;需要多张请多次调用。

请求参数

所有参数均放在 JSON 顶层。 单张参考图用 image,多张参考图用 images,同一次请求选用其中一种。

文生图 · 1K

单张参考图 · 2K

多张参考图

异步任务

客户端超时较短或需要并发提交时,改用任务接口:
创建后保存任务 ID,再轮询:
queued / running 时继续等待;succeeded 后读取 datafailed 时读取 error.message。不要在超时后自动重新创建同一任务。

成功响应

读取 data[0].url。一次请求只返回一张图。生成完成后请及时下载到自己的存储;结果 URL 不保证长期有效。

请求失败时

先看 HTTP 状态码,再读 error.message。核对 API Key 是否能访问 seedream-5.0,以及 resolutionsize 和参考图地址是否正确。向客服反馈时请提供状态码、完整错误 JSON,以及响应头中的 X-Oneapi-Request-Id