Developers

Build reels, run AI models and react to events from your own product with the AutoReel REST API and signed webhooks.

On this page

AutoReel has a public REST API, so your product, scripts or no-code tools can do what the Studio does: build reels, run any enabled model, export videos and check credits. Webhooks tell your server the moment something finishes.

The API is included with the Pro and Agency plans (see pricing).

What you can do

You want to	Use
See which models you can run and their parameters	`GET /v1/models`
Run one model (a clip, an image, a voiceover)	`POST /v1/generations`
Build a UGC video, slideshow or hook + demo reel	`POST /v1/reels`
Export a reel to MP4	`POST /v1/reels/{id}/export`
Upload your own images, video or audio	`POST /v1/files`
Check your balance	`GET /v1/credits`
Get told when work finishes	`POST /v1/webhooks`

The basics

Base URL: https://autoreel.app/api
Authentication: an API key as a Bearer token. Keys belong to a workspace and act for it.
Format: JSON in, JSON out. Every response carries an x-request-id header; include it if you contact support.
Errors: a JSON error object with a code and a human-readable message, plus fieldErrors for invalid input (status 422).
Rate limits: per key, per minute (Pro 60, Agency 300), announced in RateLimit headers. Over the limit you get a 429 with Retry-After.
Credits: API generations cost the same as in the Studio and use the same balance, holds and automatic refunds of failures (credits and billing).

Where to go next

API quickstart: your first request in five minutes.
Webhooks: receive and verify events.
API reference: every endpoint, field and error, generated from the OpenAPI 3.1 document.

Still stuck? Email [email protected] and a person will get back to you.