العودة إلى المدونة

الأدوات والتكاملاتدليل

اربط AnythingLLM بـ CheapTokens: إعداد Generic OpenAI

وجّه مزوّد Generic OpenAI في AnythingLLM إلى CheapTokens: Base URL، والمفتاح، ومعرّف النموذج الكامل، إضافة إلى نافذة السياق وMax Tokens التي يجب إدخالها.

بواسطة CheapTokens Teamنُشر في 4 دقيقة قراءة

AnythingLLM متصل بـ CheapTokens عبر مزوّد Generic OpenAI
في هذه الصفحة
  1. املأ إعدادات المزوّد
  2. لماذا يهمّ الحدّان
  3. تحقّق من الاتصال خارج AnythingLLM
  4. كم يكلّف سؤال إلى وثائقك
  5. إذا لم يعمل

يمكنك ربط AnythingLLM بـ CheapTokens عبر مزوّد Generic OpenAI الخاص به: اضبط Base URL على https://api.cheaptokens.dev/v1، وألصق مفتاح API الخاص بك، وأدخل معرّف النموذج الكامل، ثم اكتب نافذة السياق الحقيقية للنموذج وMax Tokens. الحقلان الأخيران هما اللذان يتجاهلهما الناس، وهما يحدّدان ما إذا كانت الوثيقة الطويلة تتّسع وما إذا كانت الإجابات تُقتطع.

توثيق AnythingLLM نفسه (صفحة Generic OpenAI، تم التحقق منها في 7 نوفمبر 2026، مع لافتة الإصدار v1.19.0) يصف هذا المزوّد بأنه الطريقة لاستخدام أي مزوّد LLM متوافق مع OpenAI. كما يحذّر من أنه موجّه للمطوّرين: الإعدادات الخاطئة قد تجعله يتصرف بغرابة، ويجب أن يكون معرّف النموذج مطابقًا تمامًا لما يقدّمه الـ endpoint. لذا لنكن دقيقين.

املأ إعدادات المزوّد#

افتح إعدادات LLM في AnythingLLM واختر Generic OpenAI كمزوّد. ثم تناوَل الحقول الخمسة. قد تختلف التسميات قليلًا بين الإصدارات، لذا اعتمد على المعنى.

خطوة بخطوة

خمسة حقول، بالترتيب

Base URL

أدخل جذر API، وليس الـ endpoint الكامل: https://api.cheaptokens.dev/v1. مثال التوثيق نفسه جذر ينتهي بـ /v1، وAnythingLLM يضيف /chat/completions بنفسه. إذا ألصقت المسار الكامل، تذهب الطلبات إلى عنوان خاطئ.

مفتاح API

ألصق مفتاح CheapTokens الخاص بك. إن لم يكن لديك واحد بعد، أنشئه في لوحة التحكم أولًا. تعامل معه ككلمة مرور: لا تضعه في لقطة شاشة أو في ملاحظة مساحة عمل مشتركة.

اسم نموذج المحادثة

استخدم المعرّف الكامل، مثل deepseek-ai/DeepSeek-V4-Flash-0731 أو zai-org/GLM-5.3-Flash. الأسماء المختصرة التي تراها في جداول الأسعار لا يقبلها API. لست متأكدًا من المعرّف الذي لديك؟ اعرض النماذج باستخدام GET /v1/models.

نافذة سياق النموذج

الميزانية التي يستخدمها AnythingLLM عند بناء prompt من سؤالك ومقاطع الوثائق المسترجعة وسجل المحادثة. أدخل النافذة الحقيقية للنموذج: 380000 لـ DeepSeek-V4-Flash، و390000 لـ GLM-5.3-Flash.

Max Tokens

الحد الأقصى لطول إجابة واحدة. القيمة الافتراضية في AnythingLLM هي 1024. أدخل 32768 لـ DeepSeek-V4-Flash أو 8192 لـ GLM-5.3-Flash.

Base URL في AnythingLLM: مسار الـ endpoint الكامل خاطئ، وجذر API صحيح
ألصق جذر API المنتهي بـ /v1؛ وAnythingLLM يضيف /chat/completions بنفسه

احفظ، وافتح مساحة عمل، واطرح سؤالًا. التضمينات (الجزء الذي يحوّل وثائقك إلى مقاطع قابلة للبحث) إعداد منفصل في AnythingLLM، لذا المزوّد أعلاه يغيّر فقط النموذج الذي يكتب الإجابات.

لماذا يهمّ الحدّان#

تخيّل أنك أسقطت عقدًا من 60 صفحة في مساحة عمل وطلبت ملخصًا لبنود الإنهاء. مع القيم الافتراضية، يحدث خطآن. نافذة السياق التي كتبتها قد تكون أصغر بكثير من النافذة الحقيقية للنموذج، فيقتطع AnythingLLM ما يرسله. وMax Tokens عند 1024، فيتوقف ملخص طويل في منتصف الجملة.

الحل هو إخبار AnythingLLM بالحقيقة عن النموذج:

النموذج (المعرّف) نافذة السياق الإخراج لكل إجابة
DeepSeek-V4-Flash (deepseek-ai/DeepSeek-V4-Flash-0731) 380K حتى 32,768 token
GLM-5.3-Flash (zai-org/GLM-5.3-Flash) 390K حتى 8,192 token

عادة تستحق التمسّك بها: Max Tokens سقف، وليس هدفًا. السؤال القصير يحصل على إجابة قصيرة، وتدفع فقط مقابل الـ tokens التي يكتبها النموذج فعليًا. إذا أردت فهم ما يحدث عند بلوغ حدّ ما، فإن لماذا تتوقف إجابة AI في منتصف الجملة يشرح finish_reason وmax_tokens، وما هي نافذة السياق يغطي جانب الإدخال.

يقول توثيق AnythingLLM أيضًا إن ضبط Max Tokens على 0 يستبعد حد الإخراج من الطلب. الرقم الصريح أسهل في الاستدلال، لذا سأكتب واحدًا.

تحقّق من الاتصال خارج AnythingLLM#

إذا أظهرت نافذة المحادثة خطأً، فمن المفيد معرفة ما إذا كانت المشكلة في المفتاح ومعرّف النموذج أم في شيء داخل AnythingLLM. أرسل طلبًا واحدًا مباشرة إلى API:

bash
curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-ai/DeepSeek-V4-Flash-0731", "messages": [{"role": "user", "content": "Say hi in five words."}], "max_tokens": 50}'

الـ API متوافق مع OpenAI Chat Completions، لذا تحتوي الإجابة الناجحة على النص في choices[0].message.content، وfinish_reason، وكتلة usage بأعداد الـ tokens لذلك الطلب. إذا حصلت على ذلك، فالمفتاح وBase URL ومعرّف النموذج سليمة، وكل ما تراه في AnythingLLM يأتي من الإعدادات أعلاه. المزيد عن الـ endpoint في توثيق CheapTokens.

كم يكلّف سؤال إلى وثائقك#

محادثة الوثائق كثيفة الإدخال: كل سؤال يحمل المقاطع المسترجعة. لنفترض أنك تسترجع ستة مقاطع بحوالي 600 token لكل منها، وتضيف السؤال وقليلًا من السجل، فتصل إلى نحو 4,000 token إدخال، مع إجابة من 400 token. على DeepSeek-V4-Flash، يكلّف سؤال كهذا $0.0001. إليك نفس العبء عبر النماذج لـ 200 سؤال، مع عمود OpenRouter بجانبه:

النموذج لكل طلب 200 طلبات OpenRouter، 200 طلبات
GLM-5.3-Flash $0.000096 $0.0192 $0.0334
DeepSeek-V4-Flash $0.0001 $0.02 $0.0672
MiniMax-M2.7 $0.00026 $0.052 $0.624

4,000 رمز إدخال و400 رمز إخراج لكل طلب. الأسعار لكل مليون رمز حالية وتتغير مع تعريفاتنا؛ يعرض عمود OpenRouter أسعارًا مرجعية لنفس حجم العمل.

إجمالًا، مع احتساب الإدخال والإخراج معًا، يخرج DeepSeek-V4-Flash أرخص من OpenRouter على هذا العبء. لأرقامك الخاصة، اسحب المنزلقات: tokens لكل سؤال وعدد الأسئلة يوميًا هو كل ما تحتاجه.

حاسبة التكلفة

يوم واحد من الأسئلة إلى وثائقك

رموز الإدخال لكل طلب: 4,000 · رموز الإخراج لكل طلب: 400 · الطلبات يوميًا: 50

النموذجيوميًاشهريًا
GLM-5.3-Flash$0.0048$0.144
DeepSeek-V4-Flash$0.005$0.15
MiniMax-M2.7$0.013$0.39

عدد المقاطع التي ترسلها هو أكبر رافعة. كم يكلّف سؤال RAG يوضح كيف تتحرك الفاتورة معه، والأسعار الحالية على صفحة الأسعار.

إذا لم يعمل#

معظم الأعطال واحدة من أربعة أشياء. طابِق العَرَض مع السبب:

طابق الأزواج

طابِق كل عَرَض مع سببه

  • يرفض المزوّد الطلب ويشتكي من max_tokensاضبط GENERIC_OPEN_AI_MODEL_MAX_TOKEN_KEY على max_completion_tokens وأعد تشغيل AnythingLLM
  • 401 Unauthorizedمفتاح API مفقود أو مكتوب خطأً أو ملصوق مع مسافة
  • 404 أو "model not found"معرّف النموذج هو الاسم المختصر، وليس المعرّف الكامل من قائمة النماذج
  • تتوقف الإجابات في منتصف الجملةMax Tokens لا يزال على القيمة الافتراضية 1024

خيار GENERIC_OPEN_AI_MODEL_MAX_TOKEN_KEY يأتي من توثيق AnythingLLM: يغيّر اسم الحقل الذي يحمل الحد في الطلب. لتفاصيل 401 و404، راجع API 401 أو 404: مفتاح أو base URL أو معرّف نموذج خاطئ.

تستخدم عميل محادثة آخر؟ الخطوات قريبة من Open WebUI وLibreChat وCherry Studio: base URL واحد متوافق مع OpenAI، ومفتاح واحد، ومعرّف نموذج كامل واحد.

الوسوم: