---
title: "Start Auto Broll"
method: POST
path: "/api/auto-broll"
tags: ["AutoBroll"]
---

# Start Auto Broll

`POST /api/auto-broll`

Kick off the async job. Flat 40 credits, debited on success.

## Request body

- AutoBrollRequest
  - `segments` SegmentIn[], required
    - `id` string, required
    - `text` string
    - `start` number
    - `end` number
  - `broll` BrollIn[], required
    - `node_id` string, required
    - `media_path` string
    - `label` string
    - `duration` number, nullable
    - `timeline_id` string, nullable
    - `object_key` string, nullable
  - `mode` string
  - `broll_per_minute` integer
  - `allow_reuse` boolean
  - `user_prompt` string
  - `model` string, nullable
  - `source` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/premierecopilot/apis/premierecopilot-api.md) · [All operations](https://skmtc.dev/premierecopilot/apis/premierecopilot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/premierecopilot/premierecopilot-api/revisions/fa72d3c14142/schema)