Skip to main content
POST
Seedream 5.0 Pro

简介

Seedream 5.0 Pro(模型 dola-seedream-5-0-pro-260628)支持文生图、单图生图/图片编辑、多图参考/图片融合。通过 OpenAI 兼容的图片生成接口同步调用,当前单次请求实际输出 1 张图片。 多张参考图表示输入多张图片,不表示输出多张。需要多张结果时,请分别发起多次请求。 完整多模型对比也可参见 图片生成

认证

string
必填
Bearer Token,如 Bearer sk-xxxxxxxxxx
string
必填
application/json
API Key 在平台的 API 密钥页面创建。请勿将 API Key 写入前端代码、公开仓库或客户端安装包。

模型信息

接口地址

请求参数

prompt

必填的文本指令,用于描述希望生成的内容。图生图时,prompt 同时用于说明如何使用和修改参考图。

images

传入一张或多张可被平台访问的图片 URL:
多图参考示例:
  • 图片 URL 必须能够被服务端访问,不能只在本地浏览器有效。
  • 多张图片用于参考、融合或编辑,仍生成 1 张结果图。
  • 平台当前测试和生产调用使用 images 数组字段。
  • 图片格式、大小、数量和可访问性需同时满足上游模型要求。

size

支持分辨率档位或自定义像素尺寸:
常用尺寸示例:

调用示例

成功返回

平台返回 OpenAI 兼容的图片生成结果。典型响应如下:

返回字段

data[].url 通常为临时地址。业务系统应在收到响应后立即下载并转存到自己的对象存储。

多张图片说明

该模型当前单次请求只返回 1 张图片。下面的请求可以传入 2 张参考图,但结果仍是 1 张:
如果需要 3 张独立结果,请发起 3 次请求,而不是依赖 n: 3

错误处理

请求失败时通常返回 JSON 错误对象:
常见问题: