API

Batch image generation API

BulkGen API is built for teams that need volume with structure: one request can return one image or a complete split-grid output set.

Request Fields

mode

solo | batch | variation

cols / rows

Grid structure and image count

canvasRatio

Aspect ratio of the full output canvas, such as 1:1 or 9:16.

sourceRatio

Optional override for the model generation ratio. Omit it to auto-pick the best fit.

resolution

1K / 2K / 4K

prompts

Single prompt or one prompt per cell

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": ["museum-grade collectible chair studies"]
  }'

Response

https://api.bulk-gen.com/api/v1/generate returns image payloads plus the resolved sourceRatio, the requested canvasRatio, and the derived tileRatio.

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