API

专为批量生图设计的接口

一次请求，生成整张宫格，自动切分成多张独立结果。无论是 Agent 工作流、内容流水线，还是需要批量素材的团队，都能直接接入。

请求字段

mode

生成模式：solo 单图 · batch 每格独立提示词 · variation 同主题多风格

cols / rows

宫格的列数和行数，决定最终出图数量

canvasRatio

整张画布的宽高比，例如 1:1、9:16、16:9

sourceRatio

可选。手动指定模型生成时的源图比例，留空则自动匹配最优值

resolution

输出分辨率：1K / 2K / 4K

prompts

单张提示词，或每格各一条（batch 模式下按顺序对应）

cURL

curl -X POST https://api.bulk-gen.com/api/v1/generate \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "variation",
    "cols": 3,
    "rows": 3,
    "canvasRatio": "1:1",
    "resolution": "1K",
    "prompts": ["博物馆陈列感的人像系列"]
  }'

https://api.bulk-gen.com/api/v1/generate 会返回图片结果，以及最终解析出的 sourceRatio、请求使用的 canvasRatio，还有自动推导出的 tileRatio。

{
  "images": ["base64..."],
  "sourceRatio": "1:1",
  "canvasRatio": "1:1",
  "tileRatio": "1:1",
  "credits": {
    "charged": 7.4,
    "remaining": 120.6
  }
}