AR ▾

unfilteredaiapi.comhttps://api.unfilteredaiapi.com/v1

Unfiltered AI

واجهة API لنماذج LLM الخامّة، بدون رقابة، مخصّصة للمطوّرين.

Unfiltered AIاحصل على مفتاح API

استجابة API لنموذج LLM فارغة؟ الأسباب والحلول

عند ظهور خطأ استجابة API لنموذج LLM فارغة، عادةً ما يكون الخادم قد أجاب، وتأتي السلسلة الفارغة من طريقة قراءة الرد. إليك قائمة مراجعة، مرتبة حسب تكرار ظهور كل سبب.

بيانات تتدفق عبر أنبوب زجاجي نحو فقاعة كلام فارغة، مع عدسة تكشف فرعاً مخفياً

نقاط رئيسية

  • اطبع الـ JSON الخام أولاً. معظم الردود الفارغة هي مشكلة في التحليل، وليس انقطاعاً في الخدمة.
  • تحقق من finish_reason: توضح القيم length و stop و tool_calls سبب حقل المحتوى الفارغ.
  • في التدفقات (streams)، اقرأ delta.content بشكل دفاعي وتخطّ الحزم التي لا تحتوي على خيارات.
  • قد يبدو خطأ 429 أو الوكيل الذي يخزن مؤقتاً بيانات SSE وكأنه إجابة فارغة في بعض العملاء.

ابدأ بالنظر إلى الاستجابة الخام

قبل تغيير أي إعدادات، التقط بالضبط ما تم إرجاعه. مكتبات الغلاف تخفي السبب: يعرض print(response.choices[0].message.content) None أو سلسلة فارغة سواء كان الجسم فارغًا، أو يحتوي على استدعاء أداة، أو انتهى بسقف طول، أو لم يصل.

استخدم curl بحيث لا يكون كود العميل في الطريق، وأدرج الرؤوس مع -i:

curl -i https://api.unfilteredaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Say hello in five words."}]
  }'

اقرأ ثلاثة أشياء في النتيجة. أولاً، سطر الحالة: 200 يعني أنه تم إنتاج إكمال، 429 يعني الوصول إلى حد، خطأ المصادقة مثل 401 يشير عادةً إلى المفتاح. ثانياً، choices[0].finish_reason. ثالثاً، رؤوس الاستجابة، خاصة X-Request-Id (احتفظ بها إذا اتصلت بـ support) و X-Balance-USD، الذي يظهر ما إذا كان الحساب لا يزال يحتوي على رصيد. إذا أرجعت هذه المكالمة curl نصاً، فإن الخدمة تعمل والمشكلة في عميلك. إذا أرجعت جسم خطأ، لديك السبب بالفعل.

السبب 1: الرسالة تحتوي على استدعاء أداة، وليس نصاً

إذا مررت tools وقرر النموذج استدعاء واحدة، تحتوي رسالة المساعد على tool_calls و content الخاص بها يكون null أو فارغاً. الكود الذي يقرأ فقط content يرى ردًا فارغاً. الحل هو التحقق من استدعاءات الدوال أولاً، تشغيل الدالة، إرفاق النتيجة كرسالة مع role: "tool"، واستدعاء API مرة أخرى.

from openai import OpenAI

client = OpenAI(base_url="https://api.unfilteredaiapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "What is the weather in Oslo?"}],
    tools=[{
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get current weather for a city",
            "parameters": {
                "type": "object",
                "properties": {"city": {"type": "string"}},
                "required": ["city"],
            },
        },
    }],
)

msg = resp.choices[0].message
if msg.tool_calls:
    print("tool call:", msg.tool_calls[0].function.name, msg.tool_calls[0].function.arguments)
else:
    print(msg.content)

إذا لم تكن تقصد تقديم أدوات، أزل حقلي tools و tool_choice. تعريف أداة متبقٍ من تجربة سابقة هو سبب كلاسيكي للنص الفارغ.

السبب 2: تم قطع الرد أو لم يبدأ أبداً

finish_reason يوضح معظم ما تبقى.

  • length. وصل الإكمال إلى سقف الرموز. ربما تكون قد حددت max_tokens منخفضًا جدًا، مثل 1 أو 10. المعلمة اختيارية هنا، حيث يمكن للإكمال استخدام ما تبقى من نافذة 100,000 رمز، لذا فإن أبسط حل هو حذفها. إذا كنت بحاجة إلى سقف، اضبطه مع هامش.
  • stop. انتهى النموذج بشكل طبيعي، أو أنتج أحد سلاسل stop الخاصة بك. يتوقف تسلسل التوقف مثل سطر جديد عن الرد عند أول كسر سطر، مما قد يتركك بلا شيء إذا كان النموذج يبدأ بسطر فارغ. أزل التسلسل أو خففه.
  • tool_calls. انظر القسم السابق.

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

فخ صغير آخر: وضع JSON. مع تعيين response_format إلى json_object، أضف كلمة JSON إلى تعليماتك ووصف الشكل الذي تريده. الموجّه الغامض بالإضافة إلى وضع JSON ينتج إخراجًا رقيقًا أو تافهًا يبدو فارغًا بمجرد استخراج مفتاح منه.

السبب 3: يتم قراءة التدفق بشكل خاطئ

يُرسِل البث المتدفق عبر SSE قطعاً صغيرة متعددة. لا تحمل كل قطعة نصاً. غالباً ما تحتوي القطعة الأولى على الدور فقط، وتحمل القطعة الأخيرة محتوى مع finish_reason ذي قيمة فارغة، وقد تصل القطعة الأخيرة التي تُبلغ عن الاستخدام مع قائمة choices فارغة. سيتعطل الكود الذي يُفهرس choices[0] في كل قطعة، وسيطبع الكود الذي يعامل القطعة بدون نص على أنها الإجابة الكاملة نصاً فارغاً.

from openai import OpenAI

client = OpenAI(base_url="https://api.unfilteredaiapi.com/v1", api_key="YOUR_KEY")

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write two sentences about rain."}],
    stream=True,
)

parts = []
for chunk in stream:
    if not chunk.choices:
        continue
    delta = chunk.choices[0].delta
    if delta.content:
        parts.append(delta.content)

text = "".join(parts)
print(text if text else "[no content received]")

مشكلتان بيئيتان تبدوان أيضًا مثل البث الفارغ. وسيط عكسي أو شبكة توصيل محتوى (CDN) تقوم بتخزين الاستجابة سيحتفظ بجميع القطع حتى النهاية، لذا لا يرى المتصفح شيئًا لفترة طويلة ثم كل شيء في وقت واحد، أو يحدث انتهاء المهلة أولاً. قم بإيقاف تخزين الاستجابة لمسار البث المتدفق في الوسيط الخاص بك. وبما أن البث يشغل فتحة التزامن الخاصة به حتى ينتهي، فإن البث المهجور (علامة تبويب مغلقة، أو استدعاء close() مفقود) سيستهلك فتحاتك الـ 8 تدريجيًا. ثم تحصل على 429 بدلاً من النص. لمثال خادم كامل، انظر إلى خلفية FastAPI مع البث المتدفق عبر SSE.

السبب 4: خطأ ابتلعه عميلك

تعيد بعض مكتبات HTTP سلسلة فارغة عند حالة غير 200 بدلاً من رفع الخطأ. قم بتسجيل رمز الحالة والجسم لكل فشل. الحالات التي تهمك:

الحالة أو الرمزالمعنىالإجراء المطلوب
429، rate_limitedأكثر من 300 طلب في الدقيقة باستخدام مفتاح كامل (60 في التجربة المجانية)قلّل السرعة، أضف طابور انتظار
429، concurrencyأكثر من 8 طلبات متزامنة باستخدام مفتاح كامل (2 في التجربة المجانية)حدّ عدد عمالك
429 مع Retry-After: 5حمل زائد مؤقتانتظر 5 ثوانٍ وأعد المحاولة
401عادةً ما يكون المفتاح مفقوداً أو خاطئاًتحقق من رأس Authorization: Bearer
404عادةً ما يكون المسار أو عنوان URL الأساسي خاطئاًيجب أن ينتهي عنوان URL الأساسي بـ /v1

يأخذ غلاف إعادة المحاولة البسيط بضعة أسطر ويزيل فئة كاملة من الردود الفارغة المتقطعة:

import time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.unfilteredaiapi.com/v1", api_key="YOUR_KEY")

def ask(messages, tries=4):
    for attempt in range(tries):
        try:
            r = client.chat.completions.create(model="uncensored", messages=messages)
            return r.choices[0].message.content or ""
        except RateLimitError as e:
            wait = 5
            retry_after = getattr(e.response, "headers", {}).get("retry-after")
            if retry_after:
                wait = int(retry_after)
            time.sleep(wait)
    raise RuntimeError("still limited after retries")

الطلبات الفاشلة أو المرفوضة لا تُفرض عليها رسوم، لذا لا يكلفك حلقة إعادة المحاولة ضعف التكلفة. يمكنك التأكيد بمقارنة X-Balance-USD قبل وبعد الاتصال الفاشل.

السبب 5: نقطة النهاية أو النموذج أو المفتاح الخاطئ

قائمة مراجعة قصيرة لأخطاء التكوين التي تنتج نتائج غريبة بدلاً من أخطاء صاخبة:

  1. عنوان URL الأساسي هو https://api.unfilteredaiapi.com/v1. يمكن أن يؤدي فقدان /v1 أو تكراره إلى إرجاع جسم استجابة بحالة 404، وهو ما يحوله عميل متساهل إلى رد فارغ.
  2. اسم النموذج هو uncensored، مُكتوب حرفياً. إعداد نموذج من كتالوج مزود آخر هو خطأ شائع في النسخ واللصق.
  3. توجد فقط POST /v1/chat/completions و GET /v1/models. نقطة النهاية القديمة لإكمال النصوص (completions)، ومسارات التضمين والصور غير متاحة، لذا فإن مكتبة تستدعيها لا تحصل على شيء مفيد.
  4. يُرسَل المفتاح كرمز Bearer ولا يحتوي على مسافات بيضاء أو علامات اقتباس زائدة من ملف البيئة.

استدعِ GET /v1/models باستخدام مفتاحك كاختبار للتوصيل. إذا سرد النموذج، فإن عنوان URL الأساسي والمفتاح صحيحان والمشكلة في جسم الطلب. يحتوي البدء السريع على طلب العمل الأدنى للمقارنة معه، ويغطي الأسئلة الشائعة الوصول والحدود والفوترة.

التسجيل الذي يقصر مدة الحادثة القادمة

الردود الفارغة صعبة التصحيح بعد الحادثة لأن أحداً لم يسجل ما أرسله الخادم. تحول بضعة أسطر من التسجيل اللغز إلى بحث.

  1. سجّل رأس استجابة X-Request-Id مع كل مكالمة، ناجحة كانت أم فاشلة.
  2. سجّل finish_reason، وعدادات usage وطول النص المُعاد.
  3. للبث المتدفق، سجّل عدد القطع التي وصلت وعدد التي حملت نصاً. صفر قطع مع نص يشير إلى محلل (parser) الخاص بك. صفر قطع تماماً يشير إلى الشبكة أو الوكيل.
  4. أرسل تنبيهاً حول نسبة الردود الفارغة إلى إجمالي المكالمات، وليس على الأحداث الفردية. فراغ واحد من كل ألف ضوضاء. خمسة بالمئة خطأ برمجي.

عند مقارنة طلب فاشل بآخر ناجح، قارن أولاً بين محتويات الطلب. يؤدي تغيير موجّه النظام، أو إضافة قائمة stop، أو تقليل max_tokens، أو تغيير اسم النموذج إلى معظم حالات التراجع في الأداء. أضف محتوى الطلب إلى السجلات لعينة من الطلبات، بعد إزالة أي بيانات شخصية.

إذا أفاد عدة مستخدمين بظهور فراغات في الوقت نفسه وفشل اختبار curl الخاص بك أيضاً، فغالباً لا يكون السبب في الكود الخاص بك. تحقق أولاً من وجود رمز 429 مع Retry-After، حيث يُبلَّغ عن الحمل الزائد المؤقت بهذه الطريقة، ثم أعد المحاولة بعد التأخير المحدد. إذا نجح اختبار curl وفشل التطبيق الخاص بك، فاعمل من جانب العميل باستخدام الأقسام أعلاه.

إذا كانت الإجابة قصيرة بدلاً من أن تكون فارغة

أحياناً تكون الأعراض عبارة عن إجابة في سطر واحد بينما كنت تريد صفحة. هذه مشكلة في صياغة الموجّه أكثر من كونها مشكلة في النقل. اطلب الطول والشكل اللذين تريدهما ("على الأقل 400 كلمة، في ثلاثة فقرات")، وضع التعليمات في رسالة النظام، وزد temperature قليلاً إذا كان النموذج يجيب بإيجاز. النموذج مُعدّ للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين، لذا نادراً ما تكون الإجابة القصيرة رفضاً؛ بل غالباً ما تكون نتيجة طلب غير محدد بوضوح. المحتوى الجنسي الذي يتضمن القاصرين هو الحد الصارم الوحيد ويتم رفضه دائماً.

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

أسئلة وأجوبة

لماذا تكون message.content null؟

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

هل تكلف الاستجابة الفارغة مالاً؟

لا يتم احتساب تكاليف الطلبات الفاشلة أو المرفوضة. إذا نجح الطلب وأنتجت الرموز، فستظهر لك عدادات الاستخدام، ويظهر X-Balance-USD في الرؤوس رصيدك.

هل يمكن أن تسبب نافذة السياق الكاملة إخراجاً فارغاً؟

نعم. يتشارك الموجّه والإكمال 100,000 رمز، لذا فإن السجل الممتلئ تقريباً يترك مساحة قليلة أو لا مساحة للإجابة. قم بتقليص أو تلخيص المحادثات السابقة.

لماذا لا يظهر البث الخاص بي شيئاً، ثم يظهر كل شيء في آن واحد؟

من المحتمل أن يقوم الوسيط أو شبكة توصيل المحتوى (CDN) بتخزين مؤقت لاستجابة SSE. قم بتعطيل التخزين المؤقت لذلك المسار حتى تمر القطع مع وصولها.

مفتاحك على بُعد نموذج تعبئة واحد

أنشئ حساباً، وانسخ المفتاح، ثم غيّر URL الأساسي. هذه هي الإعدادات الكاملة.

احصل على مفتاح APIاقرأ التوثيق