Changelog

Breaking changes ship behind a new path version. Everything below is additive unless marked otherwise.

v1

The first public version of the Mager API.

• GET /models — every model slug with its dynamic input_schema and available tiers.
• GET /templates, GET /templates/{templateId} — ready-to-use presets, with default input values and preview media.
• POST /generation-tasks — submit a generation, from a model or from a template.
• GET /generation-tasks/{taskId} — task status, billing, result files, and webhook delivery attempts.
• POST /generation-tasks/{taskId}/webhooks/retry — queue a new webhook delivery for a terminal task.
• GET /balance — mood balance, price multiplier, and the rate limits on your key.

Authentication is a single x-mager-api-key header. See Authentication.

Clipping Engine

Video operations, behind the new CLIPPING scope. Keys issued before this landed do not carry it — create a new key to use these endpoints. See Clipping Engine.

• POST /clips — cut short vertical clips out of a long video.
• POST /highlights — a stitched sports highlight reel.
• POST /transcriptions — word-level captions for a time range.
• GET /jobs/{jobId} — status and output for any of the above.

Task responses gained an output field carrying structured results. It is null for generation tasks, which continue to report through result.