The Aria API

Getting a key

Keys are issued by our team. Tell us your expected monthly volume and we will send you a key that starts with ak_live_, along with your monthly quota and per-minute rate limit. Keep the key on your server — never in browser code.

Server-side keys work without a website address. For browser integrations, our team can optionally lock a key to approved websites. Every key can be switched off instantly at any time.

Endpoint

POST /api/public/aria/chat

• messages — array of { role, content } with roles user or assistant.
• model — optional; defaults to Aria Basic.
• stream — optional; true returns server-sent events with { delta } chunks, ending with [DONE].

cURL

curl -X POST https://theremoteus.com/api/public/aria/chat \
  -H "Authorization: Bearer ak_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      { "role": "user", "content": "Write a polite follow-up email to a client." }
    ]
  }'

JavaScript

const res = await fetch("https://theremoteus.com/api/public/aria/chat", {
  method: "POST",
  headers: {
    Authorization: "Bearer ak_live_your_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "google/gemini-3.7-flash",
    messages: [{ role: "user", content: "Fix the grammar: we is going tomorrow" }],
  }),
});

const { reply } = await res.json();

Available models

• google/gemini-3.7-flash — Aria Basic: Fast, everyday answers — the default
• openai/chat-latest — Aria Light: Natural conversational style
• google/gemini-3.1-pro-preview — Aria Pro: Deeper reasoning, slower
• openai/gpt-5.6-terra — Aria Max: Most capable reasoning

Limits and errors

• 401 — missing or invalid key. 403 — key revoked or switched off, model not enabled, or an optional website lock rejected the request.
• 429 — per-minute rate limit reached; retry shortly.
• 402 — monthly quota used up; contact us to upgrade.