لوگوی پلتفرم Aizeمستندات پلتفرم Aize

کدهای خطا

آشنایی با کدهای خطای API و رفع مشکلات

کدهای خطا

این صفحه کدهای خطایی را که ممکن است هنگام استفاده از API پلتفرم Aize (https://api.aize.dev/v1) با آن‌ها مواجه شوید و راه رفع آن‌ها را توضیح می‌دهد.

کدهای وضعیت HTTP

200 OK

درخواست با موفقیت انجام شد.

400 Bad Request

درخواست نامعتبر یا بدساختار بود.

علل رایج:

  • JSON نامعتبر در بدنه درخواست
  • پارامترهای الزامی موجود نیست
  • مقادیر پارامتر نامعتبر
  • نام مدل پشتیبانی‌نشده

نمونه:

{
  "error": {
    "message": "Invalid request: missing 'messages' field",
    "type": "invalid_request_error",
    "code": "invalid_request"
  }
}

401 Unauthorized

احراز هویت ناموفق بود یا کلید API نامعتبر است.

علل رایج:

  • هدر Authorization ارسال نشده
  • کلید API نامعتبر
  • قالب کلید API نادرست

نمونه:

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

402 Payment Required

مشکل صورت‌حساب یا رسیدن به سقف مصرف.

علل رایج:

  • اعتبار یا موجودی ناکافی
  • رسیدن به سقف مصرف

403 Forbidden

شما مجوز انجام این عملیات را ندارید.

علل رایج:

  • کلید API به مدل درخواستی دسترسی ندارد
  • کلید مسدود یا منجمد شده است

404 Not Found

منبع درخواستی وجود ندارد.

علل رایج:

  • نقطه پایانی API نامعتبر
  • نام مدل شناسایی نشد

429 Too Many Requests

از حد مجاز نرخ درخواست عبور شده است.

علل رایج:

  • تعداد درخواست‌های زیاد در بازه زمانی کوتاه
  • عبور از سقف درخواست در هر دقیقه

راه‌حل:

  • عقب‌نشینی نمایی پیاده‌سازی کنید
  • نرخ درخواست را کاهش دهید

500 Internal Server Error

خطایی در سمت سرور رخ داد.

علل رایج:

  • اختلال موقت سرویس
  • مشکل ارائه‌دهنده بالادستی

503 Service Unavailable

سرویس موقتاً در دسترس نیست.

قالب پاسخ خطا

همه خطاها از این قالب پیروی می‌کنند:

{
  "error": {
    "message": "Human-readable error message",
    "type": "error_type",
    "code": "error_code",
    "param": "field_name"
  }
}

بهترین شیوه‌ها

پیاده‌سازی منطق تلاش مجدد

نمونه تلاش مجدد
import time
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.aize.dev/v1"
)

def make_request_with_retry(max_retries=3):
    for attempt in range(max_retries):
        try:
            response = client.chat.completions.create(
                model="gpt-4o",
                messages=[{"role": "user", "content": "Hello!"}]
            )
            return response
        except Exception as e:
            if attempt == max_retries - 1:
                raise

            # Exponential backoff
            wait_time = 2 ** attempt
            print(f"Retry {attempt + 1}/{max_retries} in {wait_time}s")
            time.sleep(wait_time)

مدیریت درست خطاها

مدیریت خطا
try:
    response = client.chat.completions.create(
        model="gpt-4o",
        messages=[{"role": "user", "content": "Hello!"}]
    )
except openai.AuthenticationError:
    print("Invalid API key")
except openai.RateLimitError:
    print("Rate limit exceeded, please wait")
except openai.APIError as e:
    print(f"API error: {e.message}")

در این صفحه