ربط n8n بـ CheapTokens: بيانات اعتماد OpenAI، Base URL

في n8n، أنشئ بيانات اعتماد OpenAI، ضع https://api.cheaptokens.dev/v1 في حقل Base URL، الصق مفتاح CheapTokens في API Key، واختر معرّف نموذج في عقدة OpenAI Chat Model. هذا هو التغيير كله: لا عقدة مخصصة، ولا حزمة مجتمع. تحتفظ سير العمل الحالية بعقدها وتحصل فقط على بيانات اعتماد جديدة.

يعمل هذا لأن واجهة CheapTokens API تتحدث بصيغة OpenAI Chat Completions (وAnthropic Messages أيضًا)، لذا لا تستطيع عقدة OpenAI في n8n التمييز بينهما. إذا كانت فكرة "base URL" جديدة عليك، هذا الشرح يغطيها في دقيقتين.

ما تمنحك إياه بيانات اعتماد n8n#

تحتوي بيانات اعتماد OpenAI في n8n على أربعة أشياء يجب ملؤها. وفقًا للشيفرة المصدرية لبيانات الاعتماد في مستودع n8n (فرع master، تم التحقق في 1 نوفمبر 2026)، فهي: API Key (مطلوب، مخفي)، Organization ID (اختياري)، Base URL (الافتراضي https://api.openai.com/v1، موصوف بأنه يتجاوز عنوان API الأساسي) ومفتاح Add Custom Header مع اسم رأس وقيمة.

تفصيل يستحق المعرفة: صفحة وثائق n8n الخاصة ببيانات اعتماد OpenAI تسرد فقط المفتاح ومعرّف المؤسسة. حقل Base URL مرئي في الشيفرة المصدرية، لذا هذا ما يعتمد عليه هذا الدليل.

عند الحفظ، تختبر n8n بيانات الاعتماد بإرسال طلب إلى {Base URL}/models مع رأس Authorization: Bearer <API Key>. لذا يظهر Base URL خاطئ أو مفتاح خاطئ هناك مباشرة، قبل أن تبني أي شيء.

قم بإعداده في أربع خطوات#

لست متأكدًا مما تكتبه كمعرّف نموذج؟ اسأل API نفسه: اعرض النماذج باستخدام GET /v1/models يعرض السلاسل الدقيقة. مقدمون مختلفون يسمون النموذج نفسه بشكل مختلف، لذا انسخ المعرّف من CheapTokens، لا من وثائق خدمة أخرى.

تحقق من المفتاح خارج n8n أولًا#

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

export CHEAPTOKENS_API_KEY="your-key-here"
curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY"

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
r = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Reply with one word: ready"}],
    max_tokens=20,
)
print(r.choices[0].message.content, r.usage)

أول سير عمل: فرز البريد الإلكتروني الوارد#

لنفترض أن صندوق بريد مشترك يتلقى حوالي ألف بريد إلكتروني يوميًا. تريد وسم كل واحد كـ billing أو bug أو other، بالإضافة إلى ملخص من سطر واحد للشخص الذي يلتقطه.

ابنِه هكذا: Gmail Trigger (أو عقدة Webhook) تغذي Basic LLM Chain. تقرأ المطالبة في السلسلة شيئًا مثل "صنّف هذا البريد الإلكتروني كـ billing أو bug أو other، ثم لخّصه في جملة واحدة"، مع إدراج نص البريد الإلكتروني من العقدة السابقة. عقدة OpenAI Chat Model تحتها، مع بيانات اعتماد CheapTokens الخاصة بك، تقوم بالتفكير.

المهمة قصيرة ومتكررة: مدخل صغير، إجابة صغيرة، آلاف التشغيلات المتطابقة. هنا يدفع النموذج الرخيص بسعر ثابت أكثر ما يدفع. لهذا النوع من العمل في CheapTokens، يمنحك DeepSeek-V4-Flash سعرًا واحدًا في أي وقت من اليوم، ونافذة سياق 380K وحتى 32,768 رمزًا لكل إجابة.

تكلفة التشغيل#

لنفترض أن كل بريد إلكتروني ينتج مطالبة بحوالي 1,500 رمز (التعليمات بالإضافة إلى البريد الإلكتروني) ويكتب النموذج حوالي 300 رمز ردًا. تكلف تشغيلة واحدة على DeepSeek-V4-Flash $0.000053. لـ 1,000 بريد إلكتروني يوميًا، إليك جميع النماذج جنبًا إلى جنب مع OpenRouter، مع احتساب المدخل والمخرج معًا:

أعداد الرموز هي افتراض لهذا المثال؛ قس أعدادك الخاصة بإرسال بريد إلكتروني نموذجي عبر فحص Python وقراءة usage، ثم استبدل الأرقام. الأسعار الحالية على صفحة التسعير.

سير عمل بنمط المحادثة مختلف. مع عقدة ذاكرة، ينتقل السجل بأكمله مع كل استدعاء، لذا ينمو المدخل مع كل رسالة. لماذا تكلف محادثة AI طويلة أكثر يوضح مدى سرعة تراكم ذلك.

إذا لم يعمل#

معظم حالات الفشل هي واحدة من ثلاثة أشياء: المفتاح، أو العنوان، أو معرّف النموذج. API 401 أو 404: مفتاح أو base URL أو معرّف نموذج خاطئ يشرح كل نص خطأ. قبل فتحه، راجع هذه القائمة:

تريد رؤية بقية الإعداد؟ وثائق CheapTokens تحتوي على مرجع API الكامل، وصفحة DeepSeek تسرد حدود النموذج. تستخدم بالفعل أداة أخرى بنفس النمط؟ Open WebUI وLangChain يتصلان بنفس الطريقة: عنوان واحد، مفتاح واحد، معرّف نموذج واحد.