Skip to main content
POST
Start a generation
This feature is in beta. During beta, endpoint schemas and behavior may change or be removed.

Authorizations

x-api-key
string
header
required

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

Headers

idempotency-key
string

Optional key for safely retrying this request. Reuse it only with the same body to get the original generation back; use a new key for a new generation.

Required string length: 1 - 255

Body

application/json
brandSessionId
string<uuid>
required

Brand this generation belongs to.

model
string
required

Exact model ID returned by GET /models.

Minimum string length: 1
input
object
required

Input matching the model's inputSchema.

briefId
string<uuid>

Completed Brief to use for image or video generation with a supported model. Rainbrand adds its guidance before your prompt and its visual assets after any references you provide.

Response

OK

data
object
required