خطاها
پاسخهای خطا در /v1 معمولاً به شکل OpenAI-compatible برمیگردند:
{
"error": {
"message": "Invalid API key",
"type": "invalid_request_error",
"param": null,
"code": "invalid_api_key"
}
}
کدهای HTTP
| HTTP | معنی |
|---|
400 | درخواست نامعتبر (مثلاً نبودن model) |
401 | API Key نامعتبر، غیرفعال یا منقضی |
402 | موجودی اعتبار (توکن) کافی نیست |
403 | دسترسی غیرفعال یا قابلیت مربوطه خاموش است |
404 | مدل پیدا نشد یا غیرفعال است |
429 | محدودیت نرخ (در صورت فعال بودن) |
500 | خطای داخلی سرور |
کدهای خطای رایج (error.code)
| کد | HTTP | توضیح |
|---|
invalid_api_key | 401 | کلید ارسال نشده یا نامعتبر است |
account_inactive | 401 | حساب کاربری یا مشتری غیرفعال است |
license_expired | 401 | لایسنس منقضی شده است |
insufficient_balance | 402 | موجودی اعتبار برای این درخواست کافی نیست |
api_disabled | 403 | دسترسی API برای این کلید/حساب خاموش است |
services_disabled | 403 | سرویسهای پنل برای این کلید خاموش است |
raw_models_disabled | 403 | دسترسی به مدلهای raw خاموش است |
vision_disabled | 403 | قابلیت vision خاموش است |
pricing_missing | 400 | قیمتگذاری مدل تنظیم نشده است |