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

# Multishot Storyboard Generate Endpoint

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

## 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/multishot-storyboard/generate`
- Auth: HTTP bearer

Generate a multi-shot storyboard from a script + labeled references via the
Claude storyboard skill. Returns {task_id, project_id}; poll task-status.

## Request body

- MultiShotStoryboardRequestDTO: Generate a multi-shot storyboard from a script via the Claude storyboard skill. The labeled references are passed to the skill, which decides how to split the script into shots, which model each shot uses, and which reference image each shot needs. Only light shape validation here.
  - `script` string, required
  - `domain_id` string, required
  - `duration` integer
  - `aspect_ratio` string
  - `references` ReferenceImageDTO[]
    - `url` string, required
    - `label` string
  - `avatar_urls` string[]
  - `offering_type` string
  - `recording_url` string, nullable
  - `overlay_layout` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-09-16** `dda5cf04b73d`: 4 info
  - added the new optional request property `avatar_urls`
  - added the new optional request property `offering_type`
  - added the new optional request property `overlay_layout`
  - added the new optional request property `recording_url`

[Operation history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/ai-video-storyboard/multishot-storyboard/generate/post.md)

---

[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)