Skip to main content
POST
Generate an image

Authorizations

x-api-key
string
header
required

Bloom API key, for example x-api-key: bloom_sk_....

Body

application/json
prompt
string
required

Description of the image to generate (1–2000 chars)

Required string length: 1 - 2000
brandSessionId
string<uuid>
required

Brand session ID (from GET /brands)

aspectRatio
enum<string>

Aspect ratio. One of "1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"

Available options:
1:1,
2:3,
3:2,
3:4,
4:3,
4:5,
5:4,
9:16,
16:9,
21:9
imageSize
enum<string>
default:2K

"2K" (default, 1 credit) or "4K" (2 credits, Plus/Pro)

Available options:
2K,
4K
model
enum<string>

Model tier. "fast" (cheaper/faster), "standard" (mid tier), or "pro" (default, highest quality).

Available options:
fast,
standard,
pro
variantCount
integer

Number of variant images to generate (1-5, default 1). Each variant costs the same credits.

Required range: 1 <= x <= 5
referenceImageIds
string<uuid>[]

IDs of uploaded or generated images to use as style/content references (max 10)

Maximum array length: 10

Response

OK

data
object
required