Generations

Start a generation

Generate a file with a selected model. A Brand ID scopes the request; pass a completed Brief to a supported model to include brand guidance and assets. Retrieve outputs with Get a generation.

post/generations

Request

Base URL
https://www.rainbrand.com/api/v1
URL
https://www.rainbrand.com/api/v1/generations
Auth
- API key in header x-api-key
- or HTTP bearer
- or OAuth 2
  Authorization code: https://www.rainbrand.com/api/auth/oauth2/authorize
  Token URL: https://www.rainbrand.com/api/auth/oauth2/token

Headers

idempotency-keystring

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.

Request body

brandSessionIdstring uuid required

Brand this generation belongs to.

modelstring required

Exact model ID returned by GET /models.

inputobject required

Input matching the model's inputSchema.

briefIdstring 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.

Example request

{
  "brandSessionId": "e6220a5e-4a68-4d39-8bb9-5105e9a3a164",
  "model": "openai/gpt-image-2.5-sunburst",
  "input": {
    "prompt": "Create a landscape launch image for Acme Inc. Atlas Pro. Center the product and include the headline \"Meet Atlas Pro\" and the call to action \"Explore Atlas Pro\".",
    "size": "1536x1024"
  },
  "briefId": "657bcf79-1f2f-47fa-90f8-9245142980ed"
}

Response

Changes

No recorded changes to this operation across all 2 revisions of this API.