图像生成

按文本提示词生成图片。OpenAI 兼容协议,LOLAI 按 model 路由到对应的文生图上游(gpt-image / 即梦 / 通义万相等)。

POSThttps://api.lolai.lol/v1/images/generations

请求参数

Header 参数

Authorizationstring必填

API Key,格式 Bearer <key>。

示例:Bearer sk-lolai-xxx

Content-Typestring必填

示例:application/json

Body 参数application/json

modelstring必填

文生图模型,见下方可用模型。

示例:gpt-image-1

promptstring必填

画面描述。越具体越可控。

示例:一只戴宇航头盔的柴犬

ninteger可选

生成张数,默认 1。

示例:1

sizestring可选

分辨率,如 1024x1024 / 1024x1792,取值看具体模型支持。

示例:1024x1024

qualitystring可选

画质档(standard / hd,部分模型支持)。

示例:standard

response_formatstring可选

url(默认)返回图片链接,或 b64_json 返回 base64。

示例:url

图像按张计费(非 token),价格随 model / size / quality 不同 —— 见定价或模型卡片。

响应

data 数组每项一张图,url 或 b64_json(取决于 response_format)。返回的 url 为临时链接,需长期保存请自行下载。

图像编辑(图生图)

POST/v1/images/edits

上传参考图 + prompt 做编辑(multipart/form-data)。字段:image(必填,多张用 image[])、mask(可选 inpaint 蒙版)、model、prompt、n、size。目前 openai 协议上游生效(即梦 / Ark 等)。

图像编辑 · curl

curl https://api.lolai.lol/v1/images/edits \
  -H "Authorization: Bearer sk-lolai-xxx" \
  -F "model=doubao-seedream-4-5-251128" \
  -F "prompt=把背景换成夜晚的星空" \
  -F "size=1024x1024" \
  -F "image=@source.png;type=image/png"

异步生成

除同步生成外,平台也支持异步图片生成:提交返 task id,轮询拿结果。

POST/v1/images/generations/tasks

提交生成任务,不扣费。Body 与 /v1/images/generations 完全一致(model / prompt / size / quality / image 参考图等),立即返回 { id, status:"submitted" }。

① 提交

curl https://api.lolai.lol/v1/images/generations/tasks \
  -H "Authorization: Bearer sk-lolai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴宇航头盔的柴犬,扁平插画",
    "size": "3840x2160"
  }'
# → {"id":"<task-id>","model":"gpt-image-2","status":"submitted"}

GET/v1/images/generations/tasks/{id}

轮询任务,每几秒一次,直到 status 为 succeeded / failed。succeeded 时带 data(OpenAI 风格 [{ url }])。成功首次命中时按张数 × 单价扣钱包(幂等,重复轮询不重复扣);失败 / 超时不扣。图片 URL 是上游临时链接,需长期保存请自行下载。

② 轮询

curl https://api.lolai.lol/v1/images/generations/tasks/<task-id> \
  -H "Authorization: Bearer sk-lolai-xxx"
# running   → {"id":"...","status":"running"}
# succeeded → {"id":"...","status":"succeeded",
#              "data":[{"url":"https://.../4k.png"}]}

可用模型

文生图模型见模型广场(筛选图像类型),价格按张随 model / size 不同。

请求与响应体

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

curl https://api.lolai.lol/v1/images/generations \
  -H "Authorization: Bearer sk-lolai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "一只戴宇航头盔的柴犬,扁平插画",
    "n": 1,
    "size": "1024x1024"
  }'

响应 · 200

{
  "created": 1715961234,
  "data": [
    { "url": "https://.../generated.png" }
  ]
}