Highlight Reel Generation
The Vision API provides powerful highlight generation capabilities for your longer videos, which can be used to generate shorter highlight reels from the video.
Usage
We offer two ways to generate reels from your videos:
- Option 1: 2‑step workflow
- Submit a job with POST /v1/creator/reels
- Poll job status with GET /v1/creator/reels/{id}until completed
 
- Submit a job with 
- Option 2: Single streaming request
- Submit a job to POST /v1/creator/reelswithstream=trueto receive real‑time progress updates (SSE)
 
- Submit a job to 
Option 1: Submit and poll
Endpoint
- POST /v1/creator/reels
Headers
- Content-Type: application/json
- X-Api-Key: YOUR_API_KEY
Request body
- video_urls(array[string], required): URLs of input videos
- prompt(string, required): Description of the reel to generate
- generation_config(object, optional):- template(“moments” | “compilation”, default: “moments”)
- num_generations(integer, default: 1)
- min_duration_seconds(integer, optional)
- max_duration_seconds(integer, optional)
 
- rendering_config(object, optional):- subtitles(boolean, default: true)
- aspect_ratio(string, default: “9:16”)
 
Bash
Python
Check generation status
- GET /v1/creator/reels/{id}
Returns job metadata and, when status is completed, an output array with generated reels.
Bash
Python
Option 2: Streaming in one request
Set stream: true to receive Server-Sent Events (SSE) with progress updates until completion.