---
title: "Generate Storyboard Collages Endpoint"
method: POST
path: "/api/v1/ai-video-storyboard/generate-collages"
tags: ["aiVideoAdStoryBoard"]
---

# Generate Storyboard Collages Endpoint

`POST /api/v1/ai-video-storyboard/generate-collages`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/ai-video-storyboard/generate-collages`
- Auth: HTTP bearer

Enqueue nano-banana 2 collage storyboard sheets (one per 4-5 beat group) as a
background task. Returns a ``task_id``; poll
``GET /ai-video-storyboard/task-status/{task_id}`` for the ``collages``.

## Request body

- GenerateStoryboardCollagesRequestDTO: Generate collage storyboard sheets (nano-banana 2). Each group becomes ONE image combining its 4-5 timestamp beats as labeled panels — far cheaper than one image per scene.
  - `groups` StoryboardCollageGroupDTO[], required
    - `scenes` StoryboardCollageSceneDTO[], required
      - `prompt` string, required
      - `start_seconds` integer, nullable
      - `end_seconds` integer, nullable
    - `previous_image_url` string, nullable
  - `reference_image_urls` string[], nullable
  - `aspect_ratio` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) - [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/8e8c18c2dc35?raw)