الخطأ 429: ماذا تفعل عندما يفشل claude-haiku-4-5-20251001

يعني الرمز 429 أنك وصلت إلى حد المعدل: تجاوز عدد الطلبات أو الرموز في نافذة زمنية حصة خطتك الحالية.

رمز 429 Too Many Requests هو استجابة تحديد معدل، وليس خطأ. يعني أن الطلب نفسه صالح لكنه تجاوز معدل الطلبات أو عدد الطلبات المتزامنة المسموح به في خطتك الحالية. يكفي الانتظار ضمن النافذة الزمنية الموضحة في ترويسة الاستجابة ثم إعادة المحاولة، دون الحاجة لتعديل جسم الطلب.

claude-haiku-4-5-20251001 مقدمة من Anthropic. كل ما في هذه الصفحة — الأسباب والحلول والبيانات المقاسة — مستقى من السلوك التشغيلي الفعلي لهذا النموذج على مستوى البوابة.

في هذه البوابة، السبب الأكثر شيوعًا هو: طلبات متزامنة كثيرة جداً. والإجراء الأول الموصى به هو: تقليل التزامن وإعادة المحاولة بتأخير متزايد.

الأسباب الشائعة

  • طلبات متزامنة كثيرة جداً
  • نفدت حصة الخطة الحالية
  • إعادة المحاولة دون تأخير

كيفية الإصلاح

  • تقليل التزامن وإعادة المحاولة بتأخير متزايد
  • الانتقال إلى خطة بحصة أكبر
  • تخزين الطلبات المتكررة مؤقتاً

مثال على إعادة المحاولة مع تأخير أُسّي

الكود أدناه يعيد المحاولة عندما يُرجع claude-haiku-4-5-20251001 الخطأ 429، حتى 5 محاولات، مع وقت انتظار متزايد وتشويش عشوائي حتى لا تُعيد الطلبات المتوازية المحاولة في اللحظة نفسها. اقرأ base URL ومفتاح API من متغيرات البيئة ولا تثبّتها داخل الكود.

import os, time, random
import requests

BASE  = os.getenv("OPENAI_BASE_URL")   # e.g. https://<your-gateway>/v1
KEY   = os.getenv("OPENAI_API_KEY")
MODEL = 'claude-haiku-4-5-20251001'


def chat(messages, retries=5):
    """Retry with exponential backoff + jitter."""
    for i in range(retries):
        try:
            r = requests.post(
                BASE + "/chat/completions",
                headers={"Authorization": "Bearer " + KEY},
                json={"model": MODEL, "messages": messages, "stream": True},
                timeout=60,
            )
            if r.status_code == 429 or r.status_code >= 500:
                time.sleep(min(2 ** i + random.uniform(0, 1), 30))
                continue
            r.raise_for_status()
            return r.json()
        except requests.exceptions.Timeout:
            time.sleep(min(2 ** i + random.uniform(0, 1), 30))
    raise RuntimeError("gave up after " + str(retries) + " retries")


print(chat([{"role": "user", "content": "hello"}]))

بيانات أساسية لهذا النموذج

TPS27.52
متوسط التأخير7338 مللي ثانية
معدل النجاح100%
نقطة نهاية APIhttps://api.airai.cc/v1
متوافق مع OpenAIOpenAI-compatible
المزوّدAnthropic
السياق200K
القدراتReasoning, Tools, Files, Vision
صيغ APIopenai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search
صيغة الفوترةp * 1 + cr * 0.1 + cc * 1.25 + cc1h * 2 + c * 5

الأسئلة الشائعة

هل أحتاج لترقية الخطة لحل 429 على claude-haiku-4-5-20251001؟

الأمر يتعلق أساساً بالحصة، وليس بعطل في النموذج نفسه. رفع سقف الخطة أو تقليل معدل الاستدعاء، كلاهما يخفف المشكلة. سعر الإدخال نحو $1.00 لكل مليون رمز. تحقق من الرصيد وحدود المعدل في لوحة التحكم أولاً، ثم افحص الكود. عند تقدير التكلفة من p * 1 + cr * 0.1 + cc * 1.25 + cc1h * 2 + c * 5، أدخل ميزانية إعادة المحاولة أيضاً.

ما الرموز التي تستحق إعادة المحاولة، وأيها لا فائدة منها؟

عادةً لا حاجة لتعديل كود العمل، يكفي ضبط وتيرة الاستدعاء. نسبة النجاح المقاسة هي 100%، لذا تكون المحاولة الأولى عادةً الأعلى عائداً. مع احتساب التكلفة بـ p * 1 + cr * 0.1 + cc * 1.25 + cc1h * 2 + c * 5، لا تُحسب الطلبات الفاشلة ضمن الاستخدام. استخدم تراجعاً أُسّياً للأخطاء القابلة لإعادة المحاولة، وأرجع الخطأ فوراً للباقي.

هل يؤدي الانتقال إلى نموذج مماثل من مورّد آخر إلى حل 429؟

احتفظ أيضاً بنموذج احتياطي جاهز. لهذا النموذج من Anthropic عدة عقد upstream يمكن للبوابة التبديل بينها. جهّز نموذجاً احتياطياً أخفّ حتى لا ينقطع المسار الرئيسي. ضع اسم النموذج في الإعدادات، فلا يحتاج تغيير المصدر إلى تعديل الكود.

ما مقدار التزامن الآمن؟

المتغيّران الحقيقيان هنا هما التزامن والمهلة، وليس النموذج نفسه. الإنتاجية المقاسة 27.52، وهو سقف مفيد للتزامن. سياق 200K يعني أن المدخلات الطويلة تزيد زمن أول رمز بشكل ملحوظ. للمخرجات الطويلة، ارفع المهلة إلى 60 ثانية أو أكثر. سوّي قمم الحمل بالدفعات أو الطوابير — أكثر استقراراً من رفع التزامن أثناء التشغيل.

أخطاء أخرى في هذا النموذج

نماذج أخرى تواجه الخطأ نفسه

العودة إلى صفحة النموذج

تحديث البيانات: 2026-10-11 19:15

الدعم الفنيالدعم المباشر
العودة إلى الأعلى