# Docs

- [RiffAds docs](/): Make realistic UGC video ads from your code or your AI agent.
- [Capabilities](/capabilities): Every capability id, what it takes and what it gives back.

- **Get started**
- Quickstarts
  - [Quickstart: REST API](/quickstart/api): Make a key, submit one video, download the file. Four curl calls.
  - [Quickstart: MCP](/quickstart/mcp): Add one URL to your AI client, sign in, make your first video.
  - [Quickstart: CLI](/quickstart/cli): Install, log in, make one video from your terminal.
  - [Quickstart: Agent Skills](/quickstart/skills): Install the RiffAds plugin in Claude Code and ask for your first video.
- Guides
  - [Talking actor ads](/guides/talking-actor): Make the voice first, then the video that lip-syncs to it.
  - [Getting results](/guides/results): Wait for a generation, read its status, and save the file before the link dies.
  - [Running workflows](/guides/workflows): Run a template or a saved workflow from code, then follow the run to the files.

- **Build with it**
- REST API
  - [Authentication](/api/authentication): Base URL, API keys, scopes, auth headers, auth errors and rate limits.
  - [Conventions](/api/conventions): Response shapes, errors, headers, bodies, pagination, replays, retries and ids.
  - [Generations](/api/generations): Estimate, submit, read, wait on and batch-read a generation.
  - [Uploads](/api/uploads): Reserve, PUT the bytes within 5 minutes, finalize, then use the asset id.
  - [Actors and voices](/api/library): List the actors and voices you can use, get their ids, pass them into a submit.
  - [Capabilities API](/api/capabilities): List what you can run and read the exact config schema for one capability.
  - [Workflows API](/api/workflows): List templates, invoke a template or a workflow, poll the run every 30 seconds.
- MCP server
  - [Connect an MCP client](/mcp/connect): One URL, a browser sign-in, and the exact config for every client.
  - [MCP tools](/mcp/tools): Every RiffAds MCP tool, its arguments and what it returns.
- CLI
  - [CLI setup](/cli/setup): Install the riffads CLI, sign in with an API key, run it in CI.
  - [CLI commands](/cli/commands): Every riffads command and flag, JSON output, exit codes and CI use.
- Agent Skills
  - [Agent Skills](/skills/overview): A Claude Code plugin that teaches your agent the right order of RiffAds calls.

- **Look it up**
- Reference
  - [Error codes](/reference/errors): Every refusal code, its HTTP status, whether to retry, and what to do.
  - [Limits](/reference/limits): Rate limits, concurrency, upload sizes, page sizes, waits and link lifetimes.
  - [Statuses and ids](/reference/statuses-and-ids): Every status for generations, batches, workflow runs, uploads and capabilities, and every id prefix.
- Policies
  - [Content policy](/policy/content): What gets refused, why resending fails, and your duty to label AI ads.
  - [Data and security](/policy/data-and-security): Where your files live, how long links last, how keys are stored, and who to tell about a leak.
  - [Legal](/policy/legal): The legal documents, your duties when you use keys and agents, and what is banned.