ChatQT

توسعه‌دهندگان

n8n با API چت‌کیوتی.

در workflowهای n8n از nodeٔ OpenAI با credential سفارشی استفاده کنید — کلید 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 که از ایران اغلب در دسترس نیست، همان nodeٔ OpenAI را با endpoint سازگار ChatQT پیکربندی کنید — ده‌ها مدل از یک credential.

بدون VPN

درخواست‌های workflow از سرور n8n شما به api.chatqt.com می‌رود — بدون نیاز به تونل به openai.com.

دسترسی پایدار

قطع‌شدن VPN دیگر workflowهای تولیدی شما را متوقف نمی‌کند.

پیش‌نیازها

قبل از شروع آماده باشید.

  • ۱ نمونهٔ n8n (Cloud یا self-hosted) با دسترسی به Credentials.
  • ۲ حساب ChatQT و یک کلید API از کنسول.
  • ۳ آشنایی اولیه با ساخت workflow در n8n (Trigger + nodeها). مستندات رسمی: docs.n8n.io

مرحله ۱

ساخت credential از نوع OpenAI

در n8n یک credential از نوع OpenAI API بسازید. به‌جای کلید OpenAI، کلید ChatQT را وارد کنید و آدرس پایه را override کنید.

  1. در n8n به Credentials بروید → Add credential.
  2. نوع OpenAI API را انتخاب کنید.
  3. در فیلد API Key کلید را از کنسول ChatQT paste کنید.
  4. فیلد Base URL (در برخی نسخه‌ها Host یا Override URL) را روی آدرس زیر بگذارید.
  5. ذخیره کنید و credential را در workflow تست کنید.
مقادیر credential 
API Key: YOUR_CHATQT_API_KEY
Base URL: https://api.chatqt.com/api/v1

برای OpenAI SDK و اکثر کلاینت‌های سازگار همین مسیر /api/v1 است — جزئیات در مستندات API.

مرحله ۲

افزودن nodeٔ OpenAI به workflow

پس از ساخت credential، nodeٔ OpenAI را اضافه کنید و مدل را از شناسهٔ کنسول انتخاب کنید.

  1. workflow جدید یا موجود → + → جستجوی OpenAI.
  2. Resource را روی Message a model (یا Chat / Text) بگذارید.
  3. credential ساخته‌شده در مرحلهٔ قبل را انتخاب کنید.
  4. در فیلد Model شناسهٔ دقیق را از کنسول وارد کنید (مثلاً openai/gpt-4.1).
  5. Prompt / Messages را پر کنید و workflow را ذخیره کنید.
نمونهٔ ساده: Manual Trigger → OpenAI (Message a model) → نمایش خروجی. برای شروع، یک پیام ثابت در node تست کنید.

مدل‌های پرکاربرد

مدل شناسه در node
GPT 4.1 openai/gpt-4.1
Claude Sonnet 4.6 anthropic/claude-sonnet-4.6
DeepSeek V4 deepseek/deepseek-v4

لیست کامل و به‌روز مدل‌ها در console.chatqt.com است.

مرحله ۳

تست workflow

  1. روی Test workflow یا اجرای دستی node کلیک کنید.
  2. خروجی باید پاسخ مدل را نشان دهد؛ در کنسول ChatQT مصرف را ببینید.

خطای ۴۰۱ (Unauthorized)

کلید API را در credential بررسی کنید؛ از کنسول ChatQT کپی شده باشد و فاصلهٔ اضافه نداشته باشد.

مدل پیدا نشد

شناسهٔ مدل را دقیقاً از کنسول کپی کنید (مثلاً openai/gpt-4.1) — نام نمایشی با slug API یکی نیست.

اتصال برقرار نمی‌شود

Base URL باید https://api.chatqt.com/api/v1 باشد (با /v1 در انتها).

سوالات متداول

پرسش‌های رایج

چرا nodeٔ OpenAI و نه nodeٔ جداگانهٔ ChatQT؟
API چت‌کیوتی با فرمت OpenAI سازگار است؛ با override کردن Base URL همان nodeٔ استاندارد n8n کافی است و نیازی به نصب community node نیست.
لیست مدل‌ها از کجاست؟
همهٔ شناسه‌های قابل استفاده در کنسول توسعه‌دهندگان نمایش داده می‌شوند — همان slug را در فیلد Model بنویسید.
تفاوت /api و /api/v1 چیست؟
برای n8n و OpenAI SDK از /api/v1 استفاده کنید. Claude CLI از مسیر بدون v1 استفاده می‌کند — راهنمای Claude CLI و مستندات API.
هزینه چگونه محاسبه می‌شود؟
مثل سایر درخواست‌های API — پرداخت به‌ازای مصرف. جدول نرخ در صفحه تعرفه‌ها.

آمادهٔ اتوماسیون با n8n هستید؟

کلید API بگیرید، credential OpenAI را تنظیم کنید و اولین workflow را اجرا کنید.

کنسول توسعه‌دهندگان پلتفرم API Claude CLI