---
title: "Generate carousel slides in one call (legacy)"
method: POST
path: "/projects/{projectId}/carousels/generate"
tags: ["Platform"]
---

# Generate carousel slides in one call (legacy)

`POST /projects/{projectId}/carousels/generate`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/projects/{projectId}/carousels/generate`
- Auth: API key in header `Authorization`

Legacy title/body dump. Compiles onto named templates. New agents should POST /carousels/compile.

## Path parameters

- `projectId` string, required

## Request body

- object
  - `clear_existing` boolean
  - `slide_duration_seconds` number
  - `background_strategy` 'solid' | 'gradient' | 'image' | 'mixed'
  - `image_model_id` 'fal-ai/gpt-image-1' | 'fal-ai/gpt-image-1.5' | 'fal-ai/gpt-image-2' | 'fal-ai/gpt-image-2.5-flare' | 'fal-ai/gpt-image-2.5-sunburst' | 'xai/grok-imagine-image-2.0' | 'bfl/flux-3-image' | 'fal-ai/bytedance/seedream/v5/lite/text-to-image' | 'bytedance/seedream/v5/pro/text-to-image' | 'fal-ai/krea-2/turbo' | 'fal-ai/krea/v2/medium/turbo/text-to-image' | 'fal-ai/krea/v2/medium/text-to-image' | 'fal-ai/nano-banana-2' | 'google/nano-banana-2.1' | 'google/nano-banana-2-lite' | 'fal-ai/nano-banana-pro'
  - `slides` object[], required
    - `title` string
    - `body` string
    - `logos` string[]
    - `background_image_url` string, uri
    - `background_prompt` string
    - `background_color` string

## Response `200`

Successful response

- object
  - `project_id` string, required
  - `slide_count` number, required
  - `job_id` string, nullable, required
  - `ai_image_run_id` string, nullable, required
  - `timeline_item_ids` string[], required
  - `overlay_ids` string[], required
  - `fill_layer_ids` string[], required
  - `ai_asset_ids` string[], required
  - `logo_asset_ids` string[], required
  - `message` string, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)