الخطأ 504: ماذا تفعل عندما يفشل claude-sonnet-4-5-20250929

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

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

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

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

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

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

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

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

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

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


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
المزوّدAnthropic
السياق1M
القدراتReasoning, Tools, Files, Vision
صيغ APIopenai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search
صيغة الفوترةp * 3 + cr * 0.3 + cc * 3.75 + cc1h * 6 + c * 15

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

كيف أمنع 504 على claude-sonnet-4-5-20250929 مسبقاً؟

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

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

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

هل سيتم خصم رسوم عندما يُرجع claude-sonnet-4-5-20250929 الخطأ 504؟

لا توجد رسوم، فالمخرجات التي أُنتجت فعلياً فقط هي ما يُحتسب ضمن الاستخدام. تُحاسب فقط على المخرجات التي أُنتجت بالفعل، أما الجزء الفاشل فلا. الفوترة تتبع p * 3 + cr * 0.3 + cc * 3.75 + cc1h * 6 + c * 15، فلا رسوم بدون مخرجات. سعر الإدخال نحو $3.00 لكل مليون رمز. تحقق من الرصيد وحدود المعدل في لوحة التحكم أولاً، ثم افحص الكود. عند تقدير التكلفة من p * 3 + cr * 0.3 + cc * 3.75 + cc1h * 6 + c * 15، أدخل ميزانية إعادة المحاولة أيضاً.

عندما يُرجع claude-sonnet-4-5-20250929 الخطأ 504، ما الحقول التي يجب قراءتها في جسم الاستجابة؟

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

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

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

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

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

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