---
title: "roasOS API"
description: "Make paid ad creative, and research the ads that your competitors run."
url: https://docs.roasos.com/
---

# 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](/quickstart).

**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)](/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](/workflows).
* **Competitor research.** Read the real ads of one company from the Facebook Ad Library. Refer to [Research competitor ads](/workflows/research-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](/brand).
* **An agent run.** Ask roasOS in words, and let it plan the calls, quote the spend and render the result. Refer to [Agent](/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](https://www.roasos.com/settings/workspace).
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](/concepts/jobs).

**[Start here](/quickstart).** Make your first request in five minutes.

[Nano Banana Pro](/models/image/nano-banana-pro) makes a still image for 2 credits. [Kling 4.0](/models/video/kling-4) makes a video. The [Coming endpoints](/models/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](/authentication).