Mosaic Motion

Generate motion videos from prompts. The Mosaic Motion API exposes a small surface for creating video generation jobs, polling them through output readiness, and submitting followups.

• Prompt to Video — Create an API initiated Mosaic Motion run from a single text prompt.
• Format Config — Set aspect ratio and duration bucket for the generated video.
• Design Systems — Use a built-in DESIGN.md preset or send custom markdown design guidance.
• Style References — Add an optional YouTube URL to guide pacing, structure, or visual direction.
• Public Attachments — Attach up to 10 publicly accessible signed URLs for source images, video, audio, or other files.
• Pollable Jobs — Receive a job_id immediately and poll for status and output.download_url.
• Source Audit — Poll responses can include sources, an additive list of source assets used in the composition with provider, rights status, and timeline usage.
• AI Agents (MCP) — Connect any MCP-compatible agent to generate videos, manage credentials, and buy credits on its own.
• ChatGPT App — Create a ChatGPT app from the Motion MCP server with OAuth and interactive video/plan widgets.

Get Started · AI Agents (MCP) · ChatGPT App · API Reference

Connect an AI agent (MCP)

AI agents can connect to Mosaic Motion over the Model Context Protocol at https://mcp.motion.so/mcp, authenticated by an OAuth 2.1 authorization server. By default the agent runs the OAuth flow and you authorize in the browser — no API key needed. Agents can also run autonomously as a service account, or fall back to a Motion API key. See the MCP & AI Agents guide.

API Base URL

https://api.motion.so/api/motion

The public API currently exposes a deliberately small surface:

• POST /sessions creates and starts a Mosaic Motion job.
• GET /sessions/{job_id} polls that job and returns output.download_url when the MP4 is ready. It can also return sources for source-asset auditing.

There is no separate public output or download endpoint.

All public calls use a Mosaic Motion API key in the Authorization header.

Authorization: Bearer motion_your_api_key

Credits

API jobs require available Mosaic Motion credits on the API key owner's account. Purchase credits and configure auto top-ups in the Motion web app at motion.so. Credit purchasing and auto top-up settings are not available through the API.

LLM Documentation

Machine-readable documentation is available at:

• /llms.txt
• /llms-full.txt
• /openapi.json