الخطأ 504: ماذا تفعل عندما يفشل glm-5.3-flash

يعني الرمز 504 أن البوابة انتهت مدة انتظارها للنموذج المصدر: أُرسل الطلب، لكن المصدر لم يستجب خلال المهلة التي تسمح بها البوابة.

رمز 504 Gateway Timeout يعني أن البوابة توقفت عن انتظار استجابة المورّد. تم تحويل الطلب، لكن لم تعد أي نتيجة خلال المهلة المحددة. تقصير المخرجات، أو تفعيل البث المباشر، أو تقليل max_tokens يحل المشكلة عادةً.

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

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

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

  • استغرق المصدر وقتاً أطول من مهلة البوابة
  • سياق طويل رفع زمن الاستدلال
  • عقدة المصدر متوقفة
  • طلب بدون بث بمخرجات طويلة جداً

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

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

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

الكود أدناه يعيد المحاولة عندما يُرجع glm-5.3-flash الخطأ 504، حتى 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 = 'glm-5.3-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"}]))

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

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

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

هل يقلل الانتقال إلى البث المباشر من 504؟

يجب تعديل معاملات الطلب، فإعادة المحاولة وحدها لن تفيد. هذه مشكلة إعدادات من جانب العميل، ولا يحتاج الخادم لأي تغيير. وسوم القدرات هي Reasoning, Tools, Files, Open Weights, Vision، وتتبعها حدود المعاملات. بالنسبة لأخطاء المعاملات، أفشل بسرعة بدل إهدار المحاولات. قصّر المدخلات الطويلة أو لخّصها — ذلك يقلل 504 بشكل ملحوظ.

هل أحتاج لترقية الخطة لحل 504 على glm-5.3-flash؟

الأمر يتعلق أساساً بالحصة، وليس بعطل في النموذج نفسه. مع الفوترة p * 0.15 + cr * 0.03 + cc * 0 + c * 0.5، تأتي تكلفة المخرجات الطويلة أساساً من رموز الإخراج. تحقق من الرصيد وحدود المعدل في لوحة التحكم أولاً، ثم افحص الكود.

هل تُحتسب الطلبات الفاشلة ضمن حصة تحديد المعدل؟

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

حزمة SDK الرسمية تعيد المحاولة تلقائياً، هل أحتاج منطقاً خاصاً بي؟

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

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

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

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

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

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