الخطأ 429: ماذا تفعل عندما يفشل hy3

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

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

hy3 مقدمة من Tencent. كل ما في هذه الصفحة — الأسباب والحلول والبيانات المقاسة — مستقى من السلوك التشغيلي الفعلي لهذا النموذج على مستوى البوابة.

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

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

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

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

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

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

الكود أدناه يعيد المحاولة عندما يُرجع hy3 الخطأ 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 = 'hy3'


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"}]))

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

نقطة نهاية APIhttps://api.airai.cc/v1
متوافق مع OpenAIOpenAI-compatible
المزوّدTencent
السياق256K
القدراتReasoning, Tools, Open Weights
صيغ APIopenai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search
صيغة الفوترةp * 0 + cr * 0 + cc * 0 + c * 0

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

كيف أمنع 429 على hy3 مسبقاً؟

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

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

إعادة المحاولة هي الخطوة الأولى الأكثر فعالية. مع احتساب التكلفة بـ p * 0 + cr * 0 + cc * 0 + c * 0، لا تُحسب الطلبات الفاشلة ضمن الاستخدام. اجعل حد المحاولات من 3 إلى 5 وأضف تشويشاً عشوائياً.

هل يؤثر 429 على الطلبات المُرسلة بالفعل إلى hy3؟

في أغلب الحالات هو أمر مؤقت ويعود من تلقاء نفسه. وسوم قدرات هذا النموذج هي Reasoning, Tools, Open Weights. إذا استمر الخطأ عدة دقائق، تواصل مع دعم المنصة للتأكد من حالة المصدر. حدّد أولاً إن كان على مستوى الحساب أم مستوى النموذج؛ التعامل معهما مختلف تماماً.

هل يرتبط 429 بطريقة فوترة hy3؟

لا توجد رسوم، فالمخرجات التي أُنتجت فعلياً فقط هي ما يُحتسب ضمن الاستخدام. تُحاسب فقط على المخرجات التي أُنتجت بالفعل، أما الجزء الفاشل فلا. الفوترة تتبع p * 0 + cr * 0 + cc * 0 + c * 0، فلا رسوم بدون مخرجات. مع احتساب التكلفة بـ p * 0 + cr * 0 + cc * 0 + c * 0، لا تُحسب الطلبات الفاشلة ضمن الاستخدام. تحقق من الرصيد وحدود المعدل في لوحة التحكم أولاً، ثم افحص الكود.

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

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

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

تحديث البيانات: 2026-10-10 18:30

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