المطوّرون

n8n مع واجهة ChatQT API.

في تدفقات عمل n8n استخدم عقدة OpenAI بـcredential مخصّص — أدخل مفتاح ChatQT API و Base URL واستدعِ نماذج GPT وClaude وغيرها بدون VPN من إيران.

ابدأ الإعداد احصل على مفتاح API

OpenAI credential

API Key: YOUR_CHATQT_API_KEY
Base URL: https://api.chatqt.com/api/v1

لماذا ChatQT؟

أتمتة n8n دون عناء الاتصال.

بدلًا من حساب OpenAI المباشر الذي غالبًا ما يكون غير متاح من إيران، اضبط عقدة OpenAI نفسها مع نقطة نهاية ChatQT المتوافقة — عشرات النماذج من credential واحد.

بدون VPN

تذهب طلبات سير العمل من خادم n8n لديك إلى api.chatqt.com — دون الحاجة إلى نفق إلى openai.com.

وصول مستقر

لم تعد انقطاعات VPN توقف تدفقات عملك الإنتاجية.

دفع واستهلاك شفافان

مفتاح API من وحدة تحكّم المطوّرين؛ التكلفة حسب الاستهلاك — التفاصيل في الأسعار.

المتطلبات المسبقة

كن جاهزًا قبل البدء.

1 نسخة من n8n (سحابية أو ذاتية الاستضافة) مع الوصول إلى Credentials.
2 حساب ChatQT و مفتاح API من وحدة التحكم.
3 إلمام أساسي ببناء سير العمل في n8n (Trigger + العقد). التوثيق الرسمي: docs.n8n.io

الخطوة 1

إنشاء credential من نوع OpenAI

في n8n أنشئ credential من نوع OpenAI API . بدلًا من مفتاح OpenAI، أدخل مفتاح ChatQT وتجاوز العنوان الأساسي.

في n8n انتقل إلى Credentials → Add credential.
النوع OpenAI API ثم اختره.
في الحقل API Key انسخ المفتاح من وحدة تحكم ChatQT والصقه.
الحقل Base URL (في بعض الإصدارات Host أو Override URL) اضبطه على العنوان أدناه.
احفظ واختبر الـcredential في سير العمل.

قيم الـcredential

API Key: YOUR_CHATQT_API_KEY
Base URL: https://api.chatqt.com/api/v1

لـOpenAI SDK ومعظم العملاء المتوافقين، المسار نفسه هو /api/v1 — التفاصيل في توثيق API.

الخطوة 2

إضافة عقدة OpenAI إلى سير العمل

بعد إنشاء الـcredential، أضف عقدة OpenAI واختر النموذج عبر معرّف وحدة التحكم.

سير عمل جديد أو قائم ← + ← بحث عن OpenAI.
اضبط Resource على Message a model (أو Chat / Text).
اختر الـcredential الذي أنشأته في الخطوة السابقة.
في الحقل Model أدخل المعرّف الدقيق من وحدة التحكم (مثلاً openai/gpt-4.1).
املأ Prompt / Messages واحفظ سير العمل.

مثال بسيط: Manual Trigger → OpenAI (Message a model) → عرض المخرجات. للبدء، اختبر رسالة ثابتة في العقدة.

النماذج الشائعة

النموذج	المعرّف في العقدة
GPT 4.1	openai/gpt-4.1
Claude Sonnet 4.6	anthropic/claude-sonnet-4.6
DeepSeek V4	deepseek/deepseek-v4

القائمة الكاملة والمحدّثة للنماذج في console.chatqt.com .

الخطوة 3

اختبار سير العمل

انقر على Test workflow أو شغّل العقدة يدويًا.
يجب أن تُظهر المخرجات رد النموذج؛ وتحقّق من الاستهلاك في وحدة تحكم ChatQT.

خطأ 401 (Unauthorized)

تحقّق من مفتاح API في الـcredential؛ يجب أن يكون منسوخًا من وحدة تحكم ChatQT وبدون مسافات إضافية.

النموذج غير موجود

انسخ معرّف النموذج تمامًا من وحدة التحكم (مثلاً openai/gpt-4.1) — الاسم المعروض ليس نفسه slug API.

تعذّر إنشاء الاتصال

يجب أن يكون Base URL https://api.chatqt.com/api/v1 (مع /v1 في النهاية).

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

لماذا عقدة OpenAI وليست عقدة ChatQT منفصلة؟

واجهة ChatQT متوافقة مع تنسيق OpenAI؛ وبتجاوز Base URL تكفي عقدة n8n القياسية ولا حاجة لتثبيت community node.

أين قائمة النماذج؟

كل المعرّفات القابلة للاستخدام تظهر في وحدة تحكّم المطوّرين — اكتب الـslug نفسه في حقل Model.

ما الفرق بين /api و/api/v1؟

لـn8n وOpenAI SDK استخدم /api/v1 . يستخدم Claude CLI المسار بدون v1 — دليل Claude CLI و توثيق API.

كيف تُحتسب التكلفة؟

مثل بقية طلبات API — الدفع حسب الاستخدام. جدول الأسعار في صفحة الأسعار.

هل أنت مستعد للأتمتة مع n8n؟

احصل على مفتاح API، واضبط credential الخاص بـOpenAI، وشغّل أول سير عمل.

وحدة تحكّم المطوّرين منصة API Claude CLI