RiffAds docs
Make realistic UGC video ads from your code or your AI agent.
Read as MarkdownSend a script and an actor. Get back a lip-synced video ad.
Works from your code, your AI agent or your terminal.
Pick your way in
REST API
HTTP and an API key. Every capability, from any language.
MCP server
Connect Claude, Cursor or any MCP client straight to your workspace.
CLISoon
One command from a terminal, a Makefile or a CI job.
Agent SkillsSoon
Drop-in playbooks that teach an agent how to use RiffAds well.
First video in 5 minutes
REST API
curl, a key, a video.
MCP
Ask Claude or Cursor for an ad.
What you can make
Every model and tool, with its id.
Before you start
- Account: sign up at app.riffads.com. A paid plan is required.
- Key: owners and admins create API keys in the app.
- MCP: no key needed. Sign in from your client.
3 things that break first integrations
| Gotcha | Fix |
|---|---|
| Talking actor ads are 2 jobs | Voice first (tts), then actor_ultra. Guide |
max_credits equal to the estimate is refused | Send at least ceil(estimate * 1.1). Generations |
| Download links expire in 10 minutes | Download the file. Don't store the link. Results |
What RiffAds won't do
- No posting. Nothing publishes to Meta, TikTok, YouTube or X. You get a file.
- No workflow building by agents. Build workflows in the app. Agents run them.
Docs for your agent
Point your agent at /llms.txt or /llms-full.txt. Add .md to any page URL for plain Markdown.