# Mosaic Motion

> Mosaic Motion creates video generation jobs from text prompts. The public API exposes a small surface for creating jobs, polling status, and submitting followups. Authentication uses Mosaic Motion API keys (prefix `motion_`) in the `Authorization` header.

Base URL: `https://api.motion.so/api/motion`

## Docs

- [Overview](https://docs.motion.so/): API surface, base URL, authentication, and credits.
- [Getting Started](https://docs.motion.so/getting-started): Create an API key, create a job, and poll for status.
- [Authentication](https://docs.motion.so/guides/authentication): Using `motion_` API keys with the `Authorization` header.
- [Credits](https://docs.motion.so/guides/credits): Credit requirements, purchasing, and auto top-ups.
- [Attachments](https://docs.motion.so/guides/attachments): Attaching up to 10 publicly accessible signed URLs.
- [Polling Jobs](https://docs.motion.so/guides/polling): Polling the job status endpoint until completion.
- [Errors](https://docs.motion.so/guides/errors): Error responses and how to handle them.

## API Reference

- [Motion API](https://docs.motion.so/reference/sessions): `POST /sessions`, `GET /sessions/{job_id}`, and followups.
- [OpenAPI Spec](https://docs.motion.so/openapi.json): Machine-readable OpenAPI definition.

## Optional

- [Full Documentation](https://docs.motion.so/llms-full.txt): The full Mosaic Motion documentation in a single file, optimized for LLMs.