ربط LibreChat بـ CheapTokens: نقطة نهاية مخصصة في librechat.yaml

LibreChat لديك يعمل، لكن قائمة النماذج تعرض فقط ما جاءت به افتراضيًا. لإضافة CheapTokens تكتب مدخلًا واحدًا endpoints.custom في librechat.yaml: اسمًا، وعنوان URL الأساسي https://api.cheaptokens.dev/v1، والمفتاح كمتغير بيئة، وقائمة بمعرّفات النماذج. أعد تشغيل الحاوية، وسيظهر نقطة نهاية "CheapTokens" في القائمة.

أسماء الحقول أدناه مأخوذة من مرجع نقاط النهاية المخصصة في LibreChat (فرع التوثيق "Latest (dev)"، تم التحقق منه في 30 أكتوبر 2026). لا تحمل الصفحة رقم إصدار، لذا إذا كان تثبيتك أقدم وسلك أحد الحقول سلوكًا مختلفًا، فقارنه بتوثيق إصدارك. أما جانب API فهو ذاك الموصوف في توثيقنا: صيغة OpenAI Chat Completions، ورصيد واحد لكل النماذج.

ما يحتاجه المدخل#

أربعة حقول مطلوبة، ولكل منها وظيفة واضحة:

• name — اسم نقطة النهاية في القائمة.
• apiKey — المفتاح. يوصي التوثيق بمرجع مثل ${VAR} بدلًا من المفتاح نفسه، حتى يبقى السر خارج ملف YAML.
• baseURL — وجهة الطلبات: https://api.cheaptokens.dev/v1.
• models.default — قائمة معرّفات النماذج المعروضة في القائمة.

هناك حقلان اختياريان يستحقان الضبط. يتيح titleConvo: true لـ LibreChat تسمية محادثاتك (تُنشأ العناوين ما لم يكن false)، وmodelDisplayLabel هو التسمية بجانب الإجابات (الافتراضي "AI"). قيمة models.fetch هي false افتراضيًا، لذا لن يطلب LibreChat قائمة نماذج من API؛ بل تأتي القائمة من models.default. ولهذا تُكتب المعرّفات أدناه كاملة.

اربطه في ثلاث خطوات#

services:
  api:
    environment:
      CHEAPTOKENS_API_KEY: ct_your_key_here

endpoints:
  custom:
    - name: 'CheapTokens'
      apiKey: '${CHEAPTOKENS_API_KEY}'
      baseURL: 'https://api.cheaptokens.dev/v1'
      models:
        default:
          - 'zai-org/GLM-5.3-Flash'
          - 'deepseek-ai/DeepSeek-V4-Flash-0731'
          - 'MiniMaxAI/MiniMax-M2.7'
      titleConvo: true
      modelDisplayLabel: 'CheapTokens'

services:
  api:
    environment:
      CHEAPTOKENS_API_KEY: ct_your_key_here
    volumes:
      - ./librechat.yaml:/app/librechat.yaml

docker compose up -d

افتح LibreChat في المتصفح، وابدأ محادثة جديدة واختر CheapTokens في قائمة نقاط النهاية. النماذج الثلاثة موجودة في القائمة. أرسل "Say hi in one sentence" ويفترض أن تصلك إجابة. إن لم تصلك، فانتقل إلى القسم الأخير.

ثلاثة نماذج في قائمة واحدة#

هذا هو الجزء الذي يجعل المحادثة المستضافة ذاتيًا جديرة بالعناء. لنفترض أنك تشغّلها لفريق صغير. معظم الأسئلة يومية: أعد صياغة هذا البريد، اشرح هذا الخطأ. لهذه يكفي zai-org/GLM-5.3-Flash، بنافذة سياق 390K وحتى 8,192 رمزًا لكل إجابة. وعندما يلصق أحدهم مستندًا طويلًا ويريد ردًا مطوّلًا، يبدّل المحادثة نفسها إلى deepseek-ai/DeepSeek-V4-Flash-0731 (سياق 380K، وحتى 32,768 رمزًا لكل إجابة). أما MiniMaxAI/MiniMax-M2.7 (سياق 180K) فهو الرأي الثالث عندما تختلف إجابتان. لا اشتراك ثانٍ، ولا مفتاح ثانٍ: الثلاثة تُحتسب من رصيد واحد.

كم تكلّف تلك المحادثة؟ خذ فريقًا من خمسة يرسلون 200 رسالة يوميًا، تحمل كل منها نحو 3,000 رمز إدخال (السجل ينمو) وتعيد نحو 500 رمز:

في الجدول، يُحتسب سعر كل نموذج لتلك الطلبات الـ200 مع الإدخال والإخراج معًا، ويأتي الإجمالي أرخص من OpenRouter. اختر الصف المطابق لاستخدامك وقارنه بـصفحة الأسعار.

إذا لم تظهر نقطة النهاية أو أجابت بخطأ#

معظم المشكلات واحدة من ثلاثة أمور. اختر ما يطابق ما تراه:

بمجرد نجاح الرسالة الأولى، يمكنك إضافة المزيد من المعرّفات إلى models.default متى أردت نموذجًا آخر في القائمة. تفضّل واجهة أمامية أخرى؟ الفكرة نفسها، عنوان URL أساسي مع مفتاح، موجودة في ربط Open WebUI بـ CheapTokens، والصورة العامة في API المتوافق مع OpenAI: ما هو base_url. أما النماذج نفسها فهي في صفحة GLM.