Getting started

Quickstart

Make your first AI request in two minutes.

Roar gives you one API for every major AI model, plus one-click hosting for your internal apps. Everything runs through a single API key.

1. Get an API key

Open your console, go to API keys → New key, and copy the key when it's shown — it appears exactly once. Keys look like roar_live_….

2. Point your SDK at Roar

The gateway is OpenAI-compatible, so any OpenAI SDK works — just change the base URL and key.

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://cloud.roar-ai.com/v1",
    api_key="roar_live_...",
)

resp = client.chat.completions.create(
    model="llama-3.3-70b",  # any model from GET /v1/models
    messages=[{"role": "user", "content": "Say hello!"}],
)
print(resp.choices[0].message.content)

JavaScript / TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://cloud.roar-ai.com/v1",
  apiKey: "roar_live_...",
});

const resp = await client.chat.completions.create({
  model: "llama-3.3-70b",
  messages: [{ role: "user", content: "Say hello!" }],
});
console.log(resp.choices[0].message.content);

curl

curl https://cloud.roar-ai.com/v1/chat/completions \
  -H "Authorization: Bearer roar_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "llama-3.3-70b",
    "messages": [{"role": "user", "content": "Say hello!"}]
  }'

3. See what you can call

GET https://cloud.roar-ai.com/v1/models lists every model your key can reach, tagged with the request types each one supports (chat, embeddings, speech, transcription).

Every response carries an x-roar-request-id header. Quote it in a support request — it matches the request in your Usage view.