مستندات / خطاها
خطاها
قالب خطاها همان قالب OpenAI است، پس SDKها آن را می‌شناسند:
{"error": {"message": "…", "type": "invalid_request_error", "param": "temperature", "code": "invalid_request", "request_id": "req_…"}}| HTTP | code |
توضیح | چه کنیم؟ |
|---|---|---|---|
| 400 | invalid_request / invalid_json |
ورودی نامعتبر است. فیلد مشکل‌دار در param آمده |
درخواست را اصلاح کنید |
| 400 | unsupported_parameter |
پارامتری فرستاده‌اید که پُل پشتیبانی نمی‌کند. پُل آن را بی‌صدا نادیده نمی‌گیرد | پارامتر را حذف کنید |
| 400 | unsupported_capability |
مدل این قابلیت را ندارد، مثلاً ابزار یا تصویر | مدل دیگری انتخاب کنید |
| 400 | provider_not_available |
تامین‌کننده‌ای که در X-Pol-Provider خواسته‌اید این مدل را ارائه نمی‌دهد |
هدر را حذف یا اصلاح کنید |
| 401 | missing_api_key / invalid_api_key |
کلید نیست، اشتباه است، لغو شده یا منقضی شده | کلید را بررسی کنید |
| 402 | insufficient_quota |
بودجه یا موجودی تمام شده است | کیف پول را شارژ یا بودجه را افزایش دهید |
| 403 | insufficient_scope |
کلید دسترسی لازم را ندارد | کلید با scope مناسب بسازید |
| 404 | model_not_found |
مدل وجود ندارد | فهرست را از /v1/models بگیرید |
| 413 / 415 | request_too_large / unsupported_media_type |
بدنه‌ی درخواست خیلی بزرگ است یا JSON نیست | — |
| 429 | rate_limit_exceeded / upstream_rate_limited |
از سقف درخواست گذشته‌اید یا تامین‌کننده محدود کرده است | به اندازه‌ی Retry-After صبر کنید |
| 502 | upstream_unavailable / upstream_auth_failed |
خطا از سمت تامین‌کننده است | دوباره تلاش کنید؛ پُل پیش از ارسال اولین بایت خودش failover می‌کند |
| 503 | no_eligible_provider |
فعلاً هیچ تامین‌کننده‌ای برای این مدل در دسترس نیست | کمی بعد تلاش کنید |
| 504 | upstream_timeout |
پاسخ تامین‌کننده بیش از حد طول کشیده است | — |
خطا وسط استریم: اگر خطا بعد از شروع استریم رخ دهد، آخرین رویداد data: {"error": …} است و [DONE] نمی‌آید. در این حالت پُل درخواست را دوباره به تامین‌کننده‌ی دیگری نمی‌فرستد، چون این کار پاسخ تکراری می‌سازد و دو بار هزینه می‌گیرد.
صورت‌حساب: درخواست ناموفقی که هیچ خروجی نداشته هزینه‌ای ندارد. اگر استریم نیمه‌کاره قطع شود، مصرف آن تخمینی ثبت و بعداً تطبیق داده می‌شود.