Docs
Terrads documentation
How to make ads with Terrads, step by step, and the API for doing the same from your own code. Every page is also plain markdown under /md/docs.
Guides
How to set up a brand, make ads, change them and ship them.
Set up your brand
Give Terrads your logo, colors, fonts, voice and products once, so every ad it makes looks and sounds like your brand from the first batch.
Make your first batch of ads
Pick a product, an angle and the sizes you need, and Terrads writes and designs a whole batch of ads in your brand. The price shows before you start.
Change one part of an ad
Mark an area of an ad and describe the change, and only that part is redone. Every change is a new version, and the original is always kept.
Add sizes and languages
Add a new size to every ad in a batch, or translate the whole batch into another language. Only the text changes; the design and product stay put.
Download your ads and their text
Download one ad, every size of it, or a whole batch, and copy the post text written for each platform, ready to paste into the ad manager.
How credits work
What costs credits, what's free, how plan and extra credits are used, and where to see every credit your team has spent or got back.
Make video ads
Brief a video ad, check every scene and the price before anything is charged, then download it in every size and keep changing it after it's made.
Make audio ads
Brief a 15- or 30-second audio ad, edit its script before anything is charged, then download the MP3, the 9:16 and 1:1 videos and the square picture.
Image tools
Make one image from a prompt, or edit, upscale, cut out, resize, translate, adapt or animate an image you have. Every edit is a new version.
Video tools
Make a video from a prompt, or edit, trim, upscale, caption, lip-sync, dub or adapt a video you have. Each edit is saved as a new version.
Audio tools
Turn a script into a voiceover, make a music bed, re-voice a recording, clean up noise, dub a clip into another language, or trim it.
Use Terrads in Claude Code
Connect Terrads to Claude Code with the plugin or the MCP server, then make ad runs for your brand and fetch the finished ads from the terminal.
Use Terrads in Cursor
Connect the Terrads MCP server to Cursor, then make ad runs for your brand, answer their questions and fetch the finished ads by asking the agent in chat.
API
Everything the app can do with an ad run, from your own code or agent. Base URL https://terrads.com/api/v1; OpenAPI 3.1 at /api/v1/openapi.json.
Quickstart
Mint an API key, create an ad run, poll it until it finishes, and download the results — the whole loop in five requests from the command line.
Authentication
How API keys work: bearer tokens, where to create and revoke them, what makes a key stop working, and which plan-level refusals a request can meet.
Runs and the interactive loop
How a run moves from queued to completed, how to read its events, and how to answer each pause: questions, copy review, and a video run's plan and stills.
Idempotency
Why every POST /runs needs an Idempotency-Key, what the API answers when a key is seen again, and how to build a retry loop that never charges you twice.
Endpoint reference
Every route under /api/v1 with its scope, rate-limit tier, parameters, request body and response fields: runs, their gates, results and the catalog.
Errors
The error envelope every endpoint uses, every error code with its HTTP status, and what to do about each one: fix the request, wait, or retry.
Rate limits
Per-key and per-team request limits by endpoint tier, the headers that report your remaining budget, and the fair-use caps that can also answer 429.
MCP server
Use the API from any MCP client: the endpoint URL, how a key authenticates, the nineteen tools and what each returns, and how to answer a run's gates.