API Reference
Every Mager API endpoint, its parameters, and its responses.
Every endpoint is authenticated with an x-mager-api-key header. See
Authentication for how to create a key.
Generation
Discover a model, pick a template, then submit and poll generation tasks.
List models
Returns every model slug you can send as the model field in POST /api/v1/generation-tasks.
List templates
Templates are presets for a model.
Get template
Returns a single template preset with its model slug, default input values, prompt metadata, and preview results.
Create generation task
Submit a generation task with a model slug from GET /api/v1/models.
Get generation task
Poll task status, billing, result files, and webhook delivery attempts.
Retry task webhook
Queue a new webhook delivery for a terminal task.
Clipping Engine
Turn a long video into short vertical clips, or match footage into a highlight reel.
Create clip
Cuts short vertical clips out of a YouTube video.
Create highlight
Builds a highlight reel from match footage: the AI scores the moments, stitches the best of them, and optionally renders the result with a template.
Get job status
Polls any clip, highlight or transcription job.
Transcription
Word-level captions with timestamps, for a YouTube video or your own media.
Create transcription
Transcribes a time range with word-level timestamps.
Get job status
Polls any clip, highlight or transcription job.
Account
Mood balance and the limits on your API key.