API Reference Live

{
  "inputTokens": 412,
  "outputTokens": 735,
  "totalTokens": 1147
}

{
  "error": "لقد أرسلت سؤالاً للتو. انتظر قليلاً قبل إرسال سؤال جديد.",
  "code": "RATE_LIMITED",
  "retryAfterSeconds": 27,
  "requestId": "0f4c1b86-27a1-4f1e-9d0a-2b7c6e5a1d33"
}

async function askWithRetry(body: unknown, attempts = 3) {
  for (let attempt = 1; attempt <= attempts; attempt++) {
    const res = await fetch("https://api.oorr.ai/api/tutor", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(body),
    });

    if (res.ok) return res.json();

    const err = await res.json();

    // Never retry a validation or safety failure — it will fail identically.
    if (err.code === "INVALID_REQUEST" || err.code === "CONTENT_BLOCKED") {
      throw new Error(`${err.code}: ${err.error}`);
    }

    // Obey the server's pace; fall back to the header, then a sane default.
    const wait = err.retryAfterSeconds
      ?? Number(res.headers.get("Retry-After"))
      ?? 30;

    if (attempt === attempts) throw new Error(`${err.code} after ${attempts} attempts`);
    await new Promise((r) => setTimeout(r, wait * 1000));
  }
}

import time
import requests

NO_RETRY = {"INVALID_REQUEST", "CONTENT_BLOCKED"}

def ask_with_retry(body, attempts=3):
    for attempt in range(1, attempts + 1):
        res = requests.post(
            "https://api.oorr.ai/api/tutor", json=body, timeout=90
        )
        if res.ok:
            return res.json()

        err = res.json()
        if err.get("code") in NO_RETRY:
            raise RuntimeError(f"{err['code']}: {err['error']}")

        wait = err.get("retryAfterSeconds") or int(
            res.headers.get("Retry-After", 30)
        )
        if attempt == attempts:
            raise RuntimeError(f"{err.get('code')} after {attempts} attempts")
        time.sleep(wait)