الخطأ timeout: ماذا تفعل عندما يفشل gemini-3.5-flash

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

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

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

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

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

  • مهلة العميل مضبوطة على قيمة صغيرة جداً
  • طُول النص التوجيهي أو السياق يرفع زمن الرمز الأول
  • النموذج يعالج مهمة استدلال طويلة
  • تذبذب الشبكة

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

  • ارفع مهلة العميل إلى 300 ثانية أو أكثر
  • فعّل البث حتى لا تنتظر الاستجابة كاملة
  • قصّر السياق أو استخدم نموذجاً أسرع
  • قلّل max_tokens

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

الكود أدناه يعيد المحاولة عندما يُرجع gemini-3.5-flash الخطأ timeout، حتى 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.5-flash'


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

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

TPS1669.89
متوسط التأخير3330 مللي ثانية
معدل النجاح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 * 1.5 + cr * 0.15 + ai * 1.5 + c * 9

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

هل أحتاج لترقية الخطة لحل timeout على gemini-3.5-flash؟

رفع سقف الخطة أو تقليل معدل الاستدعاء، كلاهما يخفف المشكلة. مع احتساب التكلفة بـ p * 1.5 + cr * 0.15 + ai * 1.5 + c * 9، لا تُحسب الطلبات الفاشلة ضمن الاستخدام. عند تقدير التكلفة من p * 1.5 + cr * 0.15 + ai * 1.5 + c * 9، أدخل ميزانية إعادة المحاولة أيضاً.

هل تؤدي إعادة المحاولة إلى تنفيذ الطلب مرتين؟

إعادة المحاولة هي الخطوة الأولى الأكثر فعالية. نسبة النجاح المقاسة هي 100%، لذا تكون المحاولة الأولى عادةً الأعلى عائداً. اجعل حد المحاولات من 3 إلى 5 وأضف تشويشاً عشوائياً. استخدم تراجعاً أُسّياً للأخطاء القابلة لإعادة المحاولة، وأرجع الخطأ فوراً للباقي.

هل أحتاج لتغيير معاملات الطلب عندما يُرجع gemini-3.5-flash الخطأ timeout؟

يجب تعديل معاملات الطلب، فإعادة المحاولة وحدها لن تفيد. نافذة السياق 1M تحدد أقصى إدخال لكل طلب، وما يتجاوزها يُرفض مباشرة. بالنسبة لأخطاء المعاملات، أفشل بسرعة بدل إهدار المحاولات. قصّر المدخلات الطويلة أو لخّصها — ذلك يقلل timeout بشكل ملحوظ.

هل يتعافى timeout تلقائياً أم يحتاج تدخلاً يدوياً؟

هذا الخطأ لا علاقة له بقدرة النموذج، بل هو على مستوى البوابة. وسوم قدرات هذا النموذج هي Reasoning, Tools, Files, Vision, Audio. عند معدل نجاح 100%، فإن حدوث timeout أحياناً يُعد تقلباً طبيعياً. إذا استمر الخطأ عدة دقائق، تواصل مع دعم المنصة للتأكد من حالة المصدر. حدّد أولاً إن كان على مستوى الحساب أم مستوى النموذج؛ التعامل معهما مختلف تماماً.

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

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

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

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

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