BXINLE API

图像生成

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

POSThttps://bxinle.com/v1/images/generations

请求参数

Header 参数
Authorizationstring必填
API Key,格式 Bearer <key>。
示例:Bearer sk-lolai-xxx
Content-Typestring必填
示例:application/json
Body 参数application/json
modelstring必填
文生图模型,见下方可用模型。
示例:gpt-image-2
promptstring必填
画面描述。越具体越可控。
示例:一只戴宇航头盔的柴犬
ninteger可选
生成张数,默认 1。
示例:1
sizestring可选
分辨率 宽x高。gpt-image 系列必须用下方推荐分辨率表里的值(命中即上游精确返回);传表外的非法尺寸会返回 400 并提示最接近的合法值,需改用该值重试(网关不会自动对齐)。其它模型(即梦 / 通义万相等)取值看各自支持。
示例:1024x1024
qualitystring可选
画质档,按模型族取值 —— gpt-image 系列(gpt-image-2 / gpt-image-2-lite)用 low / medium / high / auto,dall-e-3 用 standard / hd,dall-e-2 不支持。发了模型不认的值网关会丢弃,走上游默认档;auto 交上游自动决定(可能不严格保持请求分辨率)。
示例:high
response_formatstring可选
url(默认)返回图片链接,或 b64_json 返回 base64。
示例:url
图像有两种计费方式,按 model 定:多数模型按张 / 分辨率计费(随 size / quality 不同);部分模型(如 gpt-image-2)按 token 计费(input / output / cached tokens,对齐上游官方口径,响应附带 usage)。具体某模型走哪种,见 定价 或模型卡片。
推荐分辨率(gpt-image 系列)

约束:宽高均 /16、长边 ≤ 3840、长短边比 ≤ 3:1、总像素 655,360 ~ 8,294,400。命中下表即上游精确返回;竖版把宽高对调(如 3:4 的 4K = 2480x3312)。

比例1K2K4K
1:11024x10242048x20482880x2880
4:31360x10242048x15363312x2480
3:21536x10242048x13603504x2336
16:91824x10242048x11523840x2160
21:92384x10242048x8803840x1648

响应

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

图像编辑(图生图)

POST/v1/images/edits

上传参考图 + prompt 做编辑(multipart/form-data)。字段:image(必填,多张用 image[])、mask(可选 inpaint 蒙版)、model、prompt、n、size、quality。目前 openai 协议上游生效(即梦 / Ark 等)。注意:图生图的输出尺寸由上游决定,可能不严格等于请求的 size。

图像编辑 · curl
curl https://bxinle.com/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://bxinle.com/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://bxinle.com/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://bxinle.com/v1/images/generations \
  -H "Authorization: Bearer sk-lolai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴宇航头盔的柴犬,扁平插画",
    "n": 1,
    "size": "1024x1024"
  }'
响应 · 200
{
  "created": 1715961234,
  "data": [
    { "url": "https://.../generated.png" }
  ]
}