roasOS API

roasOS makes ad creative. It also finds the ads that your competitors run. There are two ways in.

Call the REST API from your own code. Send an HTTP request to https://api.roasos.com. You pick the model, you read the price, and you poll the job. Start at Getting started.

Connect an AI agent to the MCP server. Point an MCP client at https://mcp.roasos.com/mcp with the same API key. The agent then reads your catalog, asks for a price and does the work in a conversation. Start at Connect an AI agent (MCP).

Most callers use both. The REST API carries the production path. The agent carries the exploration and the one-off work.

What you can make

• Images and video. Examples are product shots, UGC-style ads, and lipsync. Each model has its own endpoint and its own page.
• A whole workflow in one call. Analyze an ad, remix an ad, recast a video, animate a still, or make a set of static ads. Refer to Workflows.
• Competitor research. Read the real ads of one company from the Facebook Ad Library. Refer to Research competitor ads.
• A brand memory that every call reads. roasOS keeps your brand kit, your pinned facts and your brand intelligence in one place. Refer to Brand.
• An agent run. Ask roasOS in words, and let it plan the calls, quote the spend and render the result. Refer to Agent.
• A cost you agree first. roasOS gives you the price of each paid action before it charges you.

How a paid call works

1. Make an API key in your workspace settings.
2. Quote the action to read the price. A quote is free.
3. Confirm the quote to run the action. Only this step uses credits.
4. Poll the job. Read the result when the job is terminal. Refer to Jobs.

Start here. Make your first request in five minutes.

Nano Banana Pro makes a still image for 2 credits. Kling 4.0 makes a video. The Coming endpoints page lists the models that have no endpoint yet.

Base URL

Send every REST request to this URL:

https://api.roasos.com

An MCP client uses a second host, and one API key opens both:

https://mcp.roasos.com/mcp

Get an API key

You make API keys in your workspace settings. You need a Growth plan or a Scale plan. Refer to Authentication.