Skip to content

Mosaic Motion

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

  • Prompt to Video — Create an API initiated Mosaic Motion run from a single text prompt.
  • 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 until completion.

Get Started · API Reference

API Base URL

txt
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.

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

http
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:

Mosaic Motion documentation.