عقد الأخطاء#
تستخدم الأخطاء { error: { message, type, code } }. لا تكرر المحاولة إلى ما لا نهاية.
| HTTP | الرمز | ما يجب فعله |
|---|---|---|
| 400 | invalid_request | أصلح JSON أو الحقول المطلوبة أو حدود الرموز. |
| 401 | invalid_api_key | تحقق من المفتاح ورأس Bearer؛ قم بتدويره إذا تم إلغاؤه. |
| 402 | insufficient_balance | تحقق من التعبئة المؤهلة المؤكدة والرصيد المتاح وميزانية المفتاح؛ كل تعبئة جديدة يجب ألا تقل عن 100 دولار أمريكي. |
| 403 | model_not_allowed | حدّث قائمة السماح للمفتاح أو اختر نموذجًا مسموحًا به. |
| 404 | model_not_found | اجلب /v1/models واستخدم معرفًا دقيقًا. |
| 409 | pending_reconciliation | انتظر تسوية الاستخدام قبل إعادة محاولة العملية. |
| 413 | request_too_large | قسّم الإدخال أو استخدم سياقًا أكبر. |
| 422 | unsupported_feature | اختر نشرًا يدعم الميزة. |
| 429 | quota_exceeded | احترم Retry-After إذا تم توفيره واستخدم محاولات محدودة؛ لا توجد حصة تجريبية مجانية عامة. |
| 502 | upstream_error | أعد المحاولة مع تأخير محدود؛ تحقق من الحالة. |
| 503 | service_unavailable | تحقق من حالة الخدمة وتوفر النموذج قبل إعادة المحاولة. |
تجنب العمل المكرر#
لا تفترض أن طلب الاستدلال كان مجانيًا لأن الاتصال انقطع. تحقق من سجلات الاستخدام. عمليات الإيداع مستقلة ومتكافئة حسب هوية معاملة المزود.
احصل على المساعدة#
استخدم دليل الدعم لتشخيص الخطوة الفاشلة وإعداد تقرير يتضمن رمز الخطأ ووقت UTC والنموذج واستنساخًا اصطناعيًا. أداة التقرير المحلية لا ترسل تذكرة. أبقِ بيانات الاعتماد ومحتوى العملاء خارج التقرير.
مثال على الطلب
curl https://weightsapi.com/v1/chat/completions \
-H "Authorization: Bearer $WEIGHTSAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Qwen/Qwen3-32B",
"messages": [
{
"role": "user",
"content": "Hello!"
}
],
"stream": true
}'