کدهای خطا
آشنایی با کدهای خطای 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}")