LOLAI 开发者平台

火山引擎 · 图像生成(豆包 Seedream)

豆包 Seedream 文生图 / 图生图。完全 OpenAI 兼容,可直接用 OpenAI SDK——LOLAI 已抹平火山的几处差异(输出像素下限、无 edits 端点、返回 url)。

生产环境POSThttps://api.lolai.lol/v1/images/generations

可用模型

豆包 Seedream 图像模型
doubao-seedream-5-0-260128文生图 / 图生图可选
Seedream 5.0,画质与一致性更强;推荐默认。
示例:最新
doubao-seedream-4-5-251128文生图 / 图生图可选
Seedream 4.5,上一代,稳定。

更多见 模型广场(筛选图像类型),价格按张计。

请求参数

Header 参数
Authorizationstring必填
API Key,格式 Bearer <key>。
示例:Bearer sk-lolai-xxx
Content-Typestring必填
示例:application/json
Body 参数application/json
modelstring必填
豆包 Seedream 模型,见上方可用模型。
示例:doubao-seedream-5-0-260128
promptstring必填
画面描述。越具体越可控,支持中文。
示例:一只戴宇航头盔的柴犬
ninteger可选
生成张数,默认 1。
示例:1
sizestring可选
分辨率。注意火山下限,见下方「火山特性」。
示例:2048x2048
response_format 火山不支持,传了也不生效——Seedream 固定返回图片 url(见下)。

火山特性(与其它图像模型不同处)

  • 输出像素下限 ≥ 1920×1920(3,686,400 px)。传的 size 若不足会被等比放大到达标——例如 1024x1024 实际出 ≈ 1920x1920,图比你要的大、生成也更慢(实测 10~22s)。 要精确控制尺寸,直接传 ≥ 1920² 的值,如 2048x2048 / 2304x1728。
  • 返回 url 而非 base64。链接是火山 TOS 临时签名地址,约 24 小时过期,需长期保存请收到后自行下载转存。
  • 图生图两种姿势。原生格式 /v1/images/generations + image(传 url,推荐),或 OpenAI 兼容 /v1/images/edits(上传文件)——见下方两节。 火山原生本没有 /images/edits 端点,后者由 LOLAI 适配。
  • 按张计费(非 token),价格随 model / size 不同,见 定价。

图生图 · 原生格式(推荐)

火山 Seedream 原生图生图就走 /v1/images/generations + image 入参——直接传图片 url(火山自己去拉,不用 multipart 上传文件),JSON 一把梭。

额外 Body 参数(火山原生 i2i)
imagestring | string[]可选
参考图,url 或 base64 data URI;多张传数组(Seedream 支持 1–14 张)。带 image 即为图生图。
示例:https://...png
sequential_image_generationstring可选
disabled(默认,出 1 张)/ auto(组图,一次出多张)。
示例:disabled
sequential_image_generation_optionsobject可选
组图控制,如 max_images 限制张数。auto 时按实际返回张数计费。
示例:{"max_images":3}
原生图生图 · curl(image 传 url)
curl https://api.lolai.lol/v1/images/generations \
  -H "Authorization: Bearer sk-lolai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "把背景换成夜晚的星空,保持主体不变",
    "image": "https://your-cdn.com/cat.png",
    "size": "2048x2048"
  }'
组图 · sequential=auto
{
  "model": "doubao-seedream-5-0-260128",
  "prompt": "基于这张图生成 3 个不同姿势的变体",
  "image": ["https://your-cdn.com/cat.png"],
  "sequential_image_generation": "auto",
  "sequential_image_generation_options": { "max_images": 3 }
}
image 入参仅火山 Seedream 支持;其它厂商的图生图请走下方 OpenAI 兼容的 /v1/images/edits。

图生图 · OpenAI 兼容格式

POST/v1/images/edits

标准 OpenAI 图像编辑:上传文件 + prompt(multipart/form-data)。字段:image(必填,多张用 image[])、model、prompt、n、size。 底层 LOLAI 把上传文件转成 base64 喂给 Seedream 的 generations,并固定 sequential_image_generation=disabled(只出一张)。要传 url 或要组图,用上面的原生格式。

图像编辑 · curl(上传文件)
curl https://api.lolai.lol/v1/images/edits \
  -H "Authorization: Bearer sk-lolai-xxx" \
  -F "model=doubao-seedream-5-0-260128" \
  -F "prompt=把背景换成夜晚的星空" \
  -F "size=2048x2048" \
  -F "image=@source.png;type=image/png"

响应

data 数组每项一张图,url 为火山 TOS 临时链接。需长期保存请自行下载。

请求与响应体

用下面的示例确认请求格式与返回结构。需要在线发起请求时,点击页面顶部「调试」拉起在线运行面板。

curl https://api.lolai.lol/v1/images/generations \
  -H "Authorization: Bearer sk-lolai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "一只戴宇航头盔的柴犬,扁平插画,studio light",
    "n": 1,
    "size": "2048x2048"
  }'
响应 · 200
{
  "created": 1780943800,
  "data": [
    { "url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedream-5-0/....jpeg?X-Tos-Expires=86400&..." }
  ]
}