文生图与图生图
向 /v1/images/generations 发送文字描述生成图片(文生图),或传入参考图让模型以原图为基础整体重绘(图生图);doubao-seedream-5-0-pro 等模型还支持在该端点把参考图拆解为底图与独立图层(见下文「Seedream 图层拆分」)。图片模型多为按次计费,与 token 数无关,具体模型与单价以 模型广场 为准,下文以 qwen-image-2.0 为例。
- 局部编辑、蒙版涂抹请改用 图片编辑(
/v1/images/edits,multipart 表单上传原图) - Vega 系列(
wand-vega-image-*)已迁移至 Vega 异步任务接口,同步接口不再支持
端点
POST /v1/images/generations
认证
请求头携带 Bearer 令牌(令牌获取见接入地址与鉴权):
请求体
size 的取值与计费档位随模型而异:豆包 Seedream 系列用 2K、4K 等档位串,千问系列用 宽x高 格式(如 1024x1024),以 模型广场 各模型详情为准。
文生图
返回结果中每张图片有两种格式:
url:图片的下载链接,直接访问即可获取图片文件b64_json:图片的 Base64 编码字符串,适合不便于外链下载的场景(请求时加"response_format": "b64_json")
图生图
同一端点 /v1/images/generations,在请求中传入参考图,模型以原图为基础整体重绘(改风格、改场景、保持构图主体等)。需要上传本地原图或做局部涂抹编辑时,请改用 图片编辑。
通用字段如下,参考图的传参方式与专属参数因厂商而异,请按所用模型选择下面对应的格式:
千问图生图模型(名称带 edit,如 qwen-image-edit-plus)不使用本节接口,请改用 图片编辑 的 /v1/images/edits(multipart 表单上传原图)。
豆包 Seedream 格式
doubao-seedream-4-5、doubao-seedream-5-0 等豆包 Seedream 系列模型,通过顶层 image 字段传入公网可访问的参考图 URL:
上表字段组合以 doubao-seedream-4-5、doubao-seedream-5-0 实测为准;部分 Seedream 系列模型支持多张参考图,以 模型广场 模型详情与实际响应为准。
Seedream 图层拆分
doubao-seedream-5-0-pro 等支持图层拆分的模型,在同一端点通过顶层 layer_decomposition: true 输出底图 + 若干独立图层。请求必须传入且只传 1 张参考图:
- 目前仅
doubao-seedream-5-0-pro、doubao-seedream-5-0-flash-260915支持;4.5、5.0 lite、5.0 不支持 - 输出底图 + 图层,最多 17 张,
data中每项一个url
