پرش به محتوای اصلی

مرجع خطاها

همه خطاها قالب ثابت دارند. درخواستی که پیش از رسیدن به ارائه‌دهنده رد شود هزینه‌ای ندارد؛ برای جریانی که میانه راه قطع شود، همان میزان مصرف اندازه‌گیری‌شده حساب می‌شود.

error.json
{
  "error": {
    "type": "balance_error",
    "code": "insufficient_available_balance",
    "message": "موجودی قابل‌استفاده کافی نیست. جزئیات محرمانه، محتوای درخواست و اطلاعات ارائه‌دهنده نمایش داده نمی‌شود.",
    "request_id": "…",
    "retryable": false,
    "retry_scope": "manual-review",
    "partial_delivery": false
  }
}

برنامه شما باید روی code شرط بگذارد؛ ثابت است، ولی message ممکن است بازنویسی شود. شناسه درخواست روی مسیر OpenAI در هدر x-request-id هم می‌آید. روی مسیر Anthropic بدنه قالب بومی Anthropic را دارد و code ندارد؛ آنجا به وضعیت HTTP و type تکیه کنید.

فهرست خطاهای API
وضعیت HTTPشناسهعلتراه‌حل
۴۰۰شناسهunsupported_capabilityعلتقابلیت درخواستی پشتیبانی نمی‌شودراه‌حلاین قابلیت برای این مدل یا مسیر پشتیبانی نمی‌شود؛ قابلیت‌ها و پروتکل‌های هر مدل را در صفحه همان مدل ببینید.
۴۰۰شناسهunsupported_parameterعلتپارامتر درخواستی پشتیبانی نمی‌شودراه‌حلفیلدی که فرستاده‌اید پشتیبانی نمی‌شود؛ نام آن، وقتی مشخص باشد، در فیلد parameter پاسخ می‌آید. آن را از درخواست حذف کنید.
۴۰۱شناسهapi_key_disabledعلتکلید API غیرفعال استراه‌حلکلید غیرفعال است؛ آن را در کنسول دوباره فعال کنید یا کلید دیگری بسازید.
۴۰۱شناسهapi_key_expiredعلتکلید API منقضی شده استراه‌حلکلید منقضی شده است؛ کلید تازه بسازید.
۴۰۱شناسهapi_key_invalidعلتکلید API معتبر نیستراه‌حلکلید را دوباره از متغیر محیطی بخوانید؛ وضعیت آن را در کنسول بررسی کنید.
۴۰۱شناسهapi_key_malformedعلتساختار کلید API نامعتبر استراه‌حلکلید را کامل و بدون فاصله از کنسول کپی کنید. روی مسیر Anthropic کلید را با سرآیند x-api-key بفرستید، نه Authorization.
۴۰۱شناسهapi_key_revokedعلتکلید API لغو شده استراه‌حلکلید لغو شده و دوباره فعال نمی‌شود؛ کلید تازه بسازید.
۴۰۲شناسهinsufficient_available_balanceعلتموجودی قابل‌استفاده کافی نیستراه‌حلکیف پول را شارژ کنید؛ بدهی ایجاد نمی‌شود.شارژ کیف پول ←
۴۰۳شناسهapi_key_ip_not_allowedعلتنشانی IP مجاز نیستراه‌حلدرخواست از IP خارج از فهرست مجاز آمده است. فهرست هنگام ساخت کلید تعیین می‌شود؛ کلید تازه را با IP سرور خود بسازید.
۴۰۳شناسهapi_key_leak_suspendedعلتکلید مشکوک به افشا تعلیق شدراه‌حلکلید تعلیق شده است؛ آن را بچرخانید یا لغو کنید و راهنمای اقدام فوری را دنبال کنید.اقدام فوری ←
۴۰۳شناسهapi_key_model_not_allowedعلتمدل برای این کلید مجاز نیستراه‌حلمدل در فهرست مدل‌های مجاز این کلید نیست. این فهرست هنگام ساخت کلید تعیین می‌شود و بعداً ویرایش نمی‌شود؛ کلید تازه را با این مدل بسازید.
۴۰۳شناسهapi_key_or_account_spend_limitعلتسقف هزینهٔ کلید یا حساب رد شدراه‌حلسقف هزینه کلید یا حساب رد شد؛ وضعیت کیف پول و کلید را در کنسول ببینید.
۴۰۳شناسهapi_key_scope_insufficientعلتدسترسی کلید کافی نیستراه‌حلاین کلید برای ارسال درخواست به مدل‌ها دسترسی لازم را ندارد؛ کلید تازه بسازید.
۴۰۳شناسهproject_or_account_disabledعلتپروژه یا حساب غیرفعال استراه‌حلتلاش دوباره خودکار جایز نیست؛ وضعیت را بررسی کنید.شناسهٔ درخواست و زمان رخداد را برای پیگیری امن نگه دارید.
۴۰۴شناسهmodel_not_foundعلتمدل پیدا نشدراه‌حلشناسه مدل را دقیقاً از کاتالوگ کپی کنید؛ شناسه‌ها پیشوند ارائه‌دهنده ندارند.کاتالوگ مدل‌ها ←
۴۰۹شناسهprice_version_changed_before_startعلتنسخهٔ قیمت پیش از شروع تغییر کرده استراه‌حلتلاش دوباره خودکار جایز نیست؛ وضعیت را بررسی کنید.شناسهٔ درخواست و زمان رخداد را برای پیگیری امن نگه دارید.
۴۰۹شناسهreservation_conflictعلترزرو مالی با تعارض روبه‌رو شدراه‌حلتلاش دوباره خودکار جایز نیست؛ وضعیت را بررسی کنید.شناسهٔ درخواست و زمان رخداد را برای پیگیری امن نگه دارید.
۴۱۰شناسهmodel_deprecated_scheduled_or_removedعلتمدل منسوخ، زمان‌بندی‌شده یا حذف شده استراه‌حلاین مدل از کاتالوگ خارج شده یا حذف آن زمان‌بندی شده است؛ مدل دیگری از کاتالوگ انتخاب کنید.تغییرات محصول ←
۴۲۹شناسهapi_key_concurrency_exceededعلتسقف درخواست هم‌زمان تکمیل استراه‌حلبا تأخیر و backoff نمایی، به‌عنوان یک درخواست تازه دوباره بفرستید.
۴۲۹شناسهapi_key_rpm_exceededعلتسقف درخواست در دقیقه تکمیل استراه‌حلبا backoff نمایی دوباره تلاش کنید. محدودیت RPM بعد از ساخت کلید ویرایش نمی‌شود؛ برای سقف بالاتر، کلید تازه با RPM بالاتر بسازید.
۴۲۹شناسهapi_key_tpm_exceededعلتسقف توکن در دقیقه تکمیل استراه‌حلبا backoff نمایی دوباره تلاش کنید. محدودیت TPM بعد از ساخت کلید ویرایش نمی‌شود؛ برای سقف بالاتر، کلید تازه بسازید.
۵۰۲شناسهcanonical_mapping_failureعلتنگاشت مدل داخلی ناموفق بودراه‌حلتلاش دوباره خودکار جایز نیست؛ وضعیت را بررسی کنید.شناسهٔ درخواست و زمان رخداد را برای پیگیری امن نگه دارید.
۵۰۲شناسهpartial_stream_after_first_byteعلتجریان پس از شروع ناقص ماندراه‌حلبخشی از پاسخ را گرفته‌اید و همان میزان حساب شده است؛ این درخواست را خودکار تکرار نکنید.
۵۰۲شناسهresponse_validation_failureعلتاعتبارسنجی پاسخ ناموفق بودراه‌حلتلاش دوباره خودکار جایز نیست؛ وضعیت را بررسی کنید.شناسهٔ درخواست و زمان رخداد را برای پیگیری امن نگه دارید.
۵۰۳شناسهall_same_model_endpoints_unavailableعلتهمهٔ مسیرهای همان مدل خارج از دسترس‌اندراه‌حلهیچ مسیر سالمی برای این مدل در دسترس نیست و مدل دیگری جایگزین نمی‌شود. با تأخیر دوباره تلاش کنید.منطق مسیریابی ←
۵۰۳شناسهmaintenance_modeعلتسامانه در حالت نگه‌داری استراه‌حلسامانه در حال نگه‌داری است؛ با تأخیر دوباره تلاش کنید.وضعیت سرویس ←
۵۰۳شناسهmodel_temporarily_unavailableعلتمدل موقتاً در دسترس نیستراه‌حلاین مدل موقتاً در دسترس نیست و مدل دیگری جایگزین نمی‌شود. با تأخیر دوباره تلاش کنید.
۵۰۳شناسهprovider_overloadedعلتظرفیت ارائه‌دهنده تکمیل استراه‌حلبا تأخیر و backoff نمایی، به‌عنوان یک درخواست تازه دوباره بفرستید.
۵۰۳شناسهservice_degradedعلتسرویس در وضعیت افت کیفیت استراه‌حلبا تأخیر و backoff نمایی، به‌عنوان یک درخواست تازه دوباره بفرستید.
۵۰۴شناسهprovider_timeoutعلتزمان پاسخ ارائه‌دهنده پایان یافتراه‌حلبا تأخیر و backoff نمایی، به‌عنوان یک درخواست تازه دوباره بفرستید.

وضعیت‌ها برای مسیر OpenAI (/v1/*) است و از کاتالوگ خطاهای دات‌هوش خوانده می‌شود. علت از عنوان فارسی همان کاتالوگ آمده است.

قواعد کامل تلاش دوباره و محدودیت‌ها: راهنمای خطاها و تلاش دوباره