{
  "error": "Insufficient credits. Please top up your account.",
  "code": "INSUFFICIENT_BALANCE",
  "required": 5,
  "available": 2,
  "topUpUrl": "/dashboard/billing"
}

import { AraseClient, AraseAPIError } from "arase";

const client = new AraseClient();

try {
  const result = await client.search("بحث");
} catch (error) {
  if (error instanceof AraseAPIError) {
    switch (error.code) {
      case "UNAUTHORIZED":
        console.log("مفتاح API غير صالح - تحقق من المفتاح");
        break;

      case "ACCOUNT_SUSPENDED":
        console.log("الحساب موقوف - تواصل مع الدعم");
        break;

      case "INSUFFICIENT_BALANCE":
        console.log("رصيد غير كافي - اشحن رصيدك");
        break;

      case "RATE_LIMIT_EXCEEDED":
        console.log("تجاوزت حد الطلبات - انتظر");
        break;

      default:
        console.log(error.message);
    }
  }
}

from arase import AraseClient, AraseAPIError

client = AraseClient()

try:
    result = client.search('بحث')
except AraseAPIError as e:
    if e.code == 'UNAUTHORIZED':
        print('مفتاح API غير صالح')

    elif e.code == 'ACCOUNT_SUSPENDED':
        print('الحساب موقوف - تواصل مع الدعم')

    elif e.code == 'INSUFFICIENT_BALANCE':
        print('رصيد غير كافي - اشحن رصيدك')

    elif e.code == 'RATE_LIMIT_EXCEEDED':
        print('تجاوزت حد الطلبات - انتظر')

    else:
        print(e.message)

HTTP/1.1 200 OK
X-Response-Time: 234
X-Credits-Cost: 3
X-Credits-Remaining: 97
X-RateLimit-Remaining: 58

{
  "error": "Rate limit exceeded. Please try again later.",
  "code": "RATE_LIMIT_EXCEEDED",
  "retryAfter": 60,
  "plan": "free"
}

{
  "error": "Insufficient credits. Please top up your account.",
  "code": "INSUFFICIENT_BALANCE",
  "required": 5,
  "available": 2,
  "breakdown": {
    "base": 1,
    "images": 1,
    "news": 1,
    "answer": 1,
    "depth": 1
  },
  "topUpUrl": "/dashboard/billing"
}