اتصال n8n به بیش از ۴۳۸ مدل هوش مصنوعی با پرداخت ریالی (بدون تحریم)

چرا kayaai با n8n جفت می‌شود؟

ورک‌فلوهای n8n معمولاً روی سرور مجازی ایرانی اجرا می‌شوند؛ اما سرویس‌های خارجی مثل OpenAI یا Anthropic از داخل ایران بدون پروکسی پاسخ نمی‌دهند. کایا ای آی همین مشکل را حل می‌کند: اندپوینت سازگار با OpenAI روی دامنه‌ای که از ایران مستقیم در دسترس است.

در نتیجه یک Credential در n8n می‌سازید و از همان یک کلید، در همه ورک‌فلوها و با هر مدلی که بخواهید استفاده می‌کنید. هزینه هم ریالی و بر اساس مصرف واقعی توکن است.

• سازگاری کامل با نود OpenAI Chat Model و HTTP Request
• بدون نیاز به پروکسی روی VPS ایرانی (NO_PROXY=kayaai.ir)
• پشتیبانی از GET /api/v1/models برای انتخاب مدل از فهرست
• مناسب ورک‌فلوهای حجیم؛ محدودیت نرخ per-account و شفاف

پیش‌نیازها

• یک نمونه n8n (خودمیزبان با Docker یا نسخه ابری) با نسخه ۱.۰ به بالا
• کلید API از پنل کلیدها
• اعتبار ریالی؛ ۱۰۰ اعتبار هدیه ثبت‌نام برای تست کافی است
• برای اجرای روی VPS: دسترسی به ترمینال سرور و Docker

اتصال n8n به کایا در پنج گام

1. ۱

   یک نود OpenAI Chat Model به ورک‌فلو اضافه کنید

   در ورک‌فلوی خود نود AI Agent (یا Basic LLM Chain) را اضافه کنید و زیر آن، نود OpenAI Chat Model را به عنوان مدل وصل کنید. سپس روی فیلد Credential بزنید و Create new credential را انتخاب کنید.

2. ۲

   در Credential، Base URL کایا را وارد کنید

   در پنجره Credential، فیلد Base URL را روی آدرس کایا بگذارید و کلید خود را در API Key بچسبانید. فیلدهای اختیاری مثل Organization ID و Project ID را خالی بگذارید.

   OpenAI credential fieldsکپی

   Base URL : https://kayaai.ir/api/v1
   API Key  : sk-llm-YOUR_KEY
   Organization ID : (خالی)
   Project ID      : (خالی)

   آدرس را دقیقاً همین مقدار بگذارید و /chat/completions را دستی اضافه نکنید؛ n8n خودش مسیر را کامل می‌کند.

3. ۳

   مدل را انتخاب کنید

   در نود OpenAI Chat Model، فیلد Model را باز کنید و حالت ID را انتخاب کنید تا بتوانید شناسه کامل مدل را تایپ کنید. اگر گزینه From List را بزنید، n8n فهرست مدل‌ها را از کایا می‌خواند.

   Model IDکپی

   openai/gpt-6.1-sol
   anthropic/claude-sonnet-5.5
   deepseek/deepseek-v4.1-flash

   شناسه‌ها همیشه با نام ارائه‌دهنده شروع می‌شوند (مثل anthropic/claude-sonnet-5.5). فهرست کامل در کاتالوگ مدل‌ها است.

4. ۴

   ورک‌فلو را اجرا و تست کنید

   یک پیام تست به نود بدهید و ورک‌فلو را اجرا کنید. اگر پاسخ مدل را در خروجی دیدید، اتصال کامل است. برای ورک‌فلوهای حجیم، از دکمه Execute Workflow روی داده‌های نمونه استفاده کنید.

5. ۵

   روی سرور مجازی ایرانی: بدون پروکسی راه‌اندازی کنید

   اگر n8n را با Docker اجرا می‌کنید، فقط مطمئن شوید پروکسی سراسری روی کانتینر تنظیم نشده است. یک نمونه docker-compose.yml مینیمال:

   docker-compose.ymlکپی

   services:
     n8n:
       image: docker.n8n.io/n8nio/n8n:latest
       restart: unless-stopped
       ports:
         - "5678:5678"
       environment:
         - GENERIC_TIMEZONE=Asia/Tehran
         - TZ=Asia/Tehran
         - N8N_SECURE_COOKIE=false
         # kayaai.ir is reachable directly from Iran -> keep traffic off any proxy
         - NO_PROXY=kayaai.ir,localhost,127.0.0.1
       volumes:
         - n8n_data:/home/node/.n8n
   
   volumes:
     n8n_data:

   تست اتصال از روی سرورکپی

   curl -s https://kayaai.ir/api/v1/chat/completions \
     -H "Authorization: Bearer sk-llm-YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "model": "deepseek/deepseek-v4.1-flash",
       "messages": [{"role": "user", "content": "سلام"}]
     }'

   اگر روی سرور پروکسی سراسری (HTTP_PROXY/HTTPS_PROXY) تنظیم کرده‌اید، با NO_PROXY=kayaai.ir ترافیک کایا مستقیم و بدون واسطه ارسال می‌شود.

6. ۶

   جایگزین: نود HTTP Request بدون نود آماده مدل

   اگر می‌خواهید کنترل کامل روی بدنه درخواست داشته باشید، از نود HTTP Request استفاده کنید: متد POST، آدرس https://kayaai.ir/api/v1/chat/completions و احراز هویت از نوع Header Auth با نام Authorization و مقدار Bearer sk-llm-YOUR_KEY.

   Body (JSON)کپی

   {
     "model": "anthropic/claude-sonnet-5.5",
     "messages": [
       { "role": "system", "content": "پاسخ‌ها را فارسی و کوتاه بنویس." },
       { "role": "user", "content": "{{ $json.prompt }}" }
     ],
     "stream": false
   }

انتخاب مدل مناسب هر ورک‌فلو

• دسته‌بندی و برچسب‌زنی حجیم: deepseek/deepseek-v4.1-flash
• متن فارسی، خلاصه‌سازی و گزارش‌سازی: anthropic/claude-sonnet-5.5
• عامل‌های تصمیم‌گیر با ابزار: openai/gpt-6.1-sol
• مدل امبدینگ برای جست‌وجوی معنایی: مدل‌های embedding کاتالوگ با مسیر /api/v1/embeddings

عیب‌یابی سریع