الخطأ 503: ماذا تفعل عندما يفشل gemini-3.1-pro-preview

يعني الرمز 503 أن الخدمة غير متاحة مؤقتاً، غالباً بسبب الصيانة أو الحمل الزائد. وخلافاً للرمز 429، فالمشكلة ليست في حصتك بل في سعة الخادم.

رمز 503 Service Unavailable يعني أن الخدمة لا تستطيع معالجة الطلب الآن، وعادةً ما يكون السبب التحميل الزائد أو الصيانة. التمييز عن 429 مهم: يعني 429 أن حصتك نفدت، بينما يعني 503 أن سعة الخادم غير كافية. زِد فترة التأخير بدلاً من تبديل المفتاح.

gemini-3.1-pro-preview مقدمة من Google. كل ما في هذه الصفحة — الأسباب والحلول والبيانات المقاسة — مستقى من السلوك التشغيلي الفعلي لهذا النموذج على مستوى البوابة.

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

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

  • النموذج المصدر محمّل بشكل زائد
  • الخدمة قيد الصيانة أو النشر التدريجي
  • عقدة منطقتك غير متاحة
  • ارتفاع مفاجئ في الحركة

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

  • أعد المحاولة لاحقاً مع فترة انتظار أطول
  • انتقل إلى نموذج مكافئ أقل حملاً
  • تجنب المهام الدفعية في أوقات الذروة
  • تابع إعلاناتنا

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

الكود أدناه يعيد المحاولة عندما يُرجع gemini-3.1-pro-preview الخطأ 503، حتى 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 = 'gemini-3.1-pro-preview'


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

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

TPS3738.12
متوسط التأخير26006 مللي ثانية
معدل النجاح100%
نقطة نهاية APIhttps://api.airai.cc/v1
متوافق مع OpenAIOpenAI-compatible
المزوّدGoogle
السياق1M
القدراتReasoning, Tools, Files, Vision, Audio
صيغ APIopenai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search
صيغة الفوترةp * 2 + cr * 0.2 + c * 12) : tier("200k_plus", p * 4 + cr * 0.4 + c * 18

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

هل يعتمد 503 على gemini-3.1-pro-preview على المنطقة أو العقدة؟

إذا حدث ذلك في بيئة الإنتاج فقط، فالسبب غالباً فرق في البيئة لا في النموذج. نسبة النجاح 100% تُحسب كمتوسط لكل عقدة، لذا عقدة ضعيفة واحدة تُخفض الرقم العام. هذا النموذج مقدّم من Google، وبالتالي حالة المصدر تتبع إعلانات المزوّد. سجّل معرّف الطلب عند كل فشل — هو أنفع من رمز الحالة. أعد إنتاج المشكلة أولاً في بيئة اختبار بنفس جسم الطلب.

هل أحتاج لترقية الخطة لحل 503 على gemini-3.1-pro-preview؟

رفع سقف الخطة أو تقليل معدل الاستدعاء، كلاهما يخفف المشكلة. مع الفوترة p * 2 + cr * 0.2 + c * 12) : tier("200k_plus", p * 4 + cr * 0.4 + c * 18، تأتي تكلفة المخرجات الطويلة أساساً من رموز الإخراج. تحقق من الرصيد وحدود المعدل في لوحة التحكم أولاً، ثم افحص الكود. عند تقدير التكلفة من p * 2 + cr * 0.2 + c * 12) : tier("200k_plus", p * 4 + cr * 0.4 + c * 18، أدخل ميزانية إعادة المحاولة أيضاً.

كيف أجدول المهام المجمعة عندما يُرجع gemini-3.1-pro-preview الخطأ 503؟

المتغيّران الحقيقيان هنا هما التزامن والمهلة، وليس النموذج نفسه. خفّض التزامن أولاً — معظم مشاكل معدل النقل تختفي بعدها. نافذة السياق لهذا النموذج 1M وهو من Google. سياق 1M يعني أن المدخلات الطويلة تزيد زمن أول رمز بشكل ملحوظ. ابدأ بتزامن منخفض، وراقب لدقائق، ثم زد تدريجياً.

تأخير أُسّي أم فاصل زمني ثابت؟

عادةً لا حاجة لتعديل كود العمل، يكفي ضبط وتيرة الاستدعاء. إعادة المحاولة هي الخطوة الأولى الأكثر فعالية. نسبة النجاح المقاسة هي 100%، لذا تكون المحاولة الأولى عادةً الأعلى عائداً. مع احتساب التكلفة بـ p * 2 + cr * 0.2 + c * 12) : tier("200k_plus", p * 4 + cr * 0.4 + c * 18، لا تُحسب الطلبات الفاشلة ضمن الاستخدام. اجعل حد المحاولات من 3 إلى 5 وأضف تشويشاً عشوائياً.

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

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

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

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

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