For AI agents
Coding agents (Claude Code, Codex, Cursor and similar) make Opus Motion videos for a project with the agent guide: https://opusmotion.com/agents.md.
- The guide's steps: read the project, ask the person a few questions, compare templates (each one has a timelapse, its scenes and its fields), make a draft with
POST https://opusmotion.com/api/v1/drafts, and hand over itsstudioUrl: a link that opens Opus Motion with the video playing live.PATCHwith the draft'seditTokenchanges it, and the link stays the same. - Plain HTTPS and JSON: no key and no account. Or the MCP server (https://opusmotion.com/mcp): every tool, with stills of the draft returned as images. The person exports the MP4 from the studio.
- The studio is filled through the API, not by driving the site with a browser. When the API refuses, the person is told.
- More: llms.txt · this page in Markdown · developer docs · OpenAPI
The Opus Motion API
Video templates a coding agent can read, choose and fill, and drafts that open in the studio as a link. The person reviews the video playing live and exports it. Plain HTTPS and JSON: no key and no account.
For coding agents (Claude Code, Codex, Cursor, OpenCode, Grok…) and for developers who build them in.
Paste this prompt inside your project:
Look at this project and research which Opus Motion video templates would sell it best. Compare them and propose your top picks with links. Follow https://opusmotion.com/agents.md
Start with your agent
Paste the prompt above inside a project. The agent reads https://opusmotion.com/agents.md, a short guide: it reads the repo, asks the person a few questions, proposes three or four templates with their pages, waits for the choice, and makes the draft. Nothing is rendered: the draft is a link.
- Four prompts for the kinds of ask: find the best templates for the project (the default), a launch video, a new feature, a vertical for social. Each template has its own too, with its page's link and the format on screen in it (in the studio and on its video): "Fill this Opus Motion template in 9:16 (vertical: Reels, TikTok, Shorts) with this project's texts and images: <its page>. The template and the format are chosen, don't ask about them. Follow https://opusmotion.com/agents.md".
- No plugin and no key: the agent reads pages and calls this API. Or connect the MCP server: every tool, with images back (/mcp).
- The agent writes the copy with its own model, from what the repo says, and picks real images from it.
- Exporting stays with the person, in the studio: it needs a free account, and premium templates are paid per export.
Templates
GET /api/v1/templates: The catalog. Filters: q (free text), category, tier (free or premium), format (16:9 or 9:16). Also a summary: how many are free, the premium prices per export and the categories.GET /api/v1/templates/{id}: One template, by id (t35-app-pop) or slug (app-pop), with its fields, scenes, posters and timelapse.
- Each template: title, description, durationSeconds, formats, price (free, or per export and per format; exporting needs an account), goodFor (one line), needs (the screenshots, photos, cut-outs, logo or icon it takes), timelapse and url.
- url is the template's page (/c/<category>/<slug>), with its example video: the link to give a person.
Free templates in 16:9 for a launch:
curl -s 'https://opusmotion.com/api/v1/templates?format=16:9&tier=free&q=launch'
One template with its fields:
curl -s https://opusmotion.com/api/v1/templates/app-pop
Fields
template.fields: every field an agent can fill, each with its type, label, hint, role, whether it's optional, its scene (with screenshots) and the second it shows. A video field takes a real clip, uploaded on its own (see Drafts).
| Type | What it says |
|---|---|
text | minLength and maxLength in characters; example: the demo's line, a guide to tone and length, never to copy. |
image | use (what it's for), kind (screenshot, photo, cutout, logo, icon), aspect, fit and framing (cropped or shown whole), recommendedPixels, exampleImage. A cutout field (an object on a transparent background, read from the demo's own picture) takes a PNG with real transparency around the object, or an SVG: never a photo. |
color | #RRGGBB; the brand's colors fill it when the draft sends them. |
choice | options with their labels, and the default. |
video | kind (footage of a shot, or motion of an image), stillField (the image it moves), aspect, seconds (on screen, and how much of the clip plays), recommendedPixels, exampleVideo, and its upload URL. |
- brandOwned fields (the name, the logo, the icon) are the brand's own: the demo's value is never something to copy.
- A field with onScreen: false is never drawn (a word that sets the look, a switch): its hint says what it does.
Scenes and timelapse
Models read images, not videos. Each template comes with pictures of itself, so an agent can compare templates before proposing them and see where every field goes.
- scenes: id, name, start and end, and a screenshot of each one in 16:9 and 9:16 (~960 px).
- timelapse: per format, one image (~1,600 px wide) with 12 to 16 frames in order, each with its second, and the scene's name where it changes; its frames are listed too.
- posters: the template's example, one per format.
Drafts
POST /api/v1/drafts: Make a draft: { template, format?, site?, brand?: { name, colors, logo, icon }, values: { fieldId: text | image data URL }, tweaks?: { logoScale, textScale } }. No account. Answers 201 with draftId, studioUrl, editToken, expiresAt, what was filled, what is missing, the price and a sentence to tell the person.PATCH /api/v1/drafts/{id}: Change the same draft with Authorization: Bearer <editToken>: only what changes (null takes a field back to the template's). The link stays the same: the person opens it again and sees the changes.PUT /api/v1/drafts/{id}/media/{field}: A real clip for a video field: the file itself as the body (MP4 or QuickTime, up to 40 MB), with the editToken. Its container, shape and length are checked; it counts as an update and the link stays the same.GET /api/v1/drafts/{id}: A draft, read-only. A draft lasts 30 days; after that 410.POST /api/v1/drafts/{id}/frames: See the draft: { formats?, times?, sheet? } with the editToken answers 202 and a poll URL. The draft is rendered the way its export will be: stills (up to 6 moments, JPEG 1,280 px) or one contact sheet per format (up to 9), with a layout check of those moments.GET /api/v1/drafts/{id}/frames/{job}: The look: status, then frames or sheets (URLs) and layout findings. About half a minute; frames last a day.
- Images are base64 data URLs: PNG, JPEG, WebP or SVG, up to 4 MB each (logo and icon 1 MB), 12 MB per request: more than that goes in parts, the rest with PATCH (a draft keeps the images it already has). A draft holds one image per image field. They are parsed for real, and nothing is fetched from a URL.
- Values are checked with the export's own rules: a field that doesn't fit answers 422 with one problem per field (its code, its limit and its current length), and nothing is saved or cut.
- Opening the link uploads nothing for the person; the images and clips are copied into their account when they export.
- Clips are real footage from the project (screen recordings, demos), never generated or faked. Without one, a placeholder plays and the person can upload one or animate the image in the studio.
- Tweaks are safe adjustments a template declares in template.tweaks, apart from the fields: logoScale (0.7 to 1.4, held inside the frame's safe zone) and textScale (0.85 to 1.15; texts already shrink to fit, so going up only grows the short ones). They travel with the draft into the studio and the export; in a PATCH, null takes one back to 1. A tweak the template doesn't take, or a value out of its range, is a 422 (unsupported_tweak, tweak_out_of_range with min and max).
Make a draft:
curl -s -X POST https://opusmotion.com/api/v1/drafts -H 'content-type: application/json' \
-d '{"template":"product-launch","brand":{"name":"Acme","colors":["#0A84FF"]},"values":{"request":"Turn this sketch into a product page"}}'
Add a real clip to a video field:
curl -s -T demo.mp4 -H 'content-type: video/mp4' -H 'authorization: Bearer <editToken>' \
https://opusmotion.com/api/v1/drafts/<draftId>/media/shot01Motion
Change it (same link):
curl -s -X PATCH https://opusmotion.com/api/v1/drafts/<draftId> -H 'authorization: Bearer <editToken>' \
-H 'content-type: application/json' -d '{"values":{"ctaLabel":"Build it"}}'
Limits
- Reads: 120 requests a minute per network (the MCP server, 60).
- New drafts: 10 a minute and 50 a day per network. Updates (PATCH) don't count as new drafts: 30 a minute per network and 300 a day per draft.
- Every answer says where you stand: RateLimit-Policy and RateLimit (IETF draft), plus X-RateLimit-Limit, -Remaining and -Reset. Past a limit: 429 with Retry-After, and for new drafts, a whatToDo line (update the draft you have, or stop).
- An agent that hits a limit tells the person and stops; it never fills the studio through a browser.
Errors
JSON with a stable code: {"error": "template_not_found", "message": "…"}.
| Code | When |
|---|---|
template_not_found (404) | No template with that id or slug. |
invalid_values (422) | Something doesn't fit; problems lists each field (too_long, too_short, demo_value, unknown_field, aspect_mismatch, image_too_large, not_a_cutout: a cut-out field got a photo or a picture without real transparency, duplicate_image: the same picture in two fields…). |
bad_edit_token (401) | A PATCH or a clip upload without the draft's editToken. |
unsupported_tweak · tweak_out_of_range (422) | A tweak the template doesn't list in template.tweaks, or a value outside its min and max (both come back). |
video_too_large (413) | A clip over 40 MB. |
invalid_video · unsupported_video · video_too_short (422) | Not an MP4 or QuickTime, a WebM, or shorter than what the template plays of it. |
draft_not_found (404) · draft_expired (410) | No such draft, or it is past its 30 days. |
rate_limited · daily_draft_limit (429) | Past a limit; see Retry-After. |
Pro templates
A Pro template is a designed video kept as data. An agent puts a brand on it with operations: every text, image and color, and it can hide a layer; the layout, timing and motion stay the template's. The person opens the editor link, can change anything by hand and exports it, priced like a premium template of its length. The full guide: /pro/AGENTS.md.
GET /api/v1/pro/templates: The Pro templates.GET /api/v1/pro/templates/{id}: Everything to put a brand on one: summary, acts, palette, the export price, and every layer with its note, timing, props and its box per format (the layout is read-only).POST /api/v1/pro/drafts: { template, ops } → 201 with draftId, editToken (once), editorUrl, warnings and the export price. Operations: set (a text, an image, colors, hidden), recolor, video (background); all or nothing (422 lists every issue, content_only for a change beyond content).PATCH /api/v1/pro/drafts/{id}: { ops, revision? } with the editToken; a stale revision answers 409.GET /api/v1/pro/drafts/{id}: The draft as it is now: its layers and both formats' docs.POST /api/v1/pro/drafts/{id}/media: An image as the body (PNG, JPEG, WebP or SVG, 4 MB) with the editToken → its src for an image layer.POST /api/v1/pro/drafts/{id}/frames: See the draft: stills or contact sheets per format with a layout check by layer, like a catalog draft's frames.
MCP server
Every tool an agent needs, in one server: Streamable HTTP at https://opusmotion.com/api/mcp (POST, JSON-RPC 2.0), no authentication. Tools: search_templates, get_template, studio_link, join_studio_session, create_draft, update_draft, get_draft, media_upload_command, list_pro_templates, get_pro_template, create_pro_draft, edit_pro_draft, get_pro_draft, upload_pro_image, look_at_pro_draft, look_at_draft, get_frames; resources (the guides, any template or draft) and prompts too. Each tool with its inputs, and how to connect each client: https://opusmotion.com/mcp. Manifest: https://opusmotion.com/.well-known/mcp/manifest.json.
Claude Desktop, Cursor or any MCP client:
{ "mcpServers": { "opus-motion": { "url": "https://opusmotion.com/api/mcp" } } }
Versioning and other files
- The version is in the path (/api/v1). Additions don't change it; a breaking change ships as /api/v2, and /api/v1 keeps working at least six months after, announced with Deprecation and Sunset headers.
- https://opusmotion.com/agents.md (the agent's guide) · https://opusmotion.com/llms.txt · https://opusmotion.com/openapi.json · https://opusmotion.com/.well-known/api-catalog · https://opusmotion.com/sitemap.md
- Every page has a Markdown version: send Accept: text/markdown, or add .md to its path (the home is /index.md).
When to use Opus Motion
- Someone needs a short launch, product or promo video for their own brand, app, tool or website, and has no agency, editor or motion designer.
- Someone wants a branded video for X, LinkedIn, Instagram, TikTok or YouTube, in 16:9 or vertical 9:16, from their website alone.
- Someone is comparing promo video templates by style, length, format or price.
Not a fit:
- Editing long videos or live-action footage.
- A one-off custom animation brief. Ask for a new template at /requests instead.
Questions: [email protected].