مرجع خطاها
همه خطاها قالب ثابت دارند. درخواستی که پیش از رسیدن به ارائهدهنده رد شود هزینهای ندارد؛ برای جریانی که میانه راه قطع شود، همان میزان مصرف اندازهگیریشده حساب میشود.
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 تکیه کنید.
| وضعیت 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/*) است و از کاتالوگ خطاهای داتهوش خوانده میشود. علت از عنوان فارسی همان کاتالوگ آمده است.
قواعد کامل تلاش دوباره و محدودیتها: راهنمای خطاها و تلاش دوباره