Generate Carousel
carousels_board_generateWrite and design a full carousel from a prompt into the project board: hook, body slides, ending call to action and a post caption, styled with the brand kit or a preset style, with optional AI photos (photos finish in the background; pendingAssetIds lists them). Replaces the current board and renames the project. Uses AI and image credits; a retry with the same idempotency key and input replays the first result without generating or charging again.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>",
"expectedRevision": "<expectedRevision>",
"prompt": "<prompt>",
"goal": "<goal>",
"slideCount": "<slideCount>",
"style": "<style>",
"withImages": "<withImages>",
"imageModelId": "<imageModelId>",
"characterIds": "<characterIds>",
"places": "<places>",
"sourceUrl": "<sourceUrl>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "carousels_board_generate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | ||
| style | Yes | Ready-made look; null keeps the carousel's current look. | |
| places | Yes | Saved places to set the photos in (a Story Kit location); their reference photo keeps the same room. Empty lets the prompt decide. | |
| prompt | Yes | ||
| projectId | Yes | UUID string. | |
| sourceUrl | Yes | A public web page the carousel is about (full URL or domain); its text grounds the slides. Null reads a web address written in the prompt, if any. | |
| slideCount | Yes | Total slides including cover and call to action; null lets the prompt decide. | |
| withImages | Yes | ||
| workspaceId | No | ||
| characterIds | Yes | Saved AI characters to cast in the photos, by id; their saved references keep their faces. Empty lets the prompt decide. | |
| imageModelId | Yes | Image model for the generated photos; null uses Nano Banana 2. Ignored when withImages is false. | |
| idempotencyKey | Yes | ||
| expectedRevision | Yes | Replace the board only at this revision; null replaces the latest board. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||