اتصال n8n به API هوش مصنوعی از ایران
در n8n هر نود هوش مصنوعی — از نود OpenAI تا AI Agent و زنجیرههای LLM — با یک Credential کار میکند. آن Credential یک فیلد Base URL دارد؛ کافی است بهجای آدرس رسمی OpenAI، آدرس 1xAi را بگذاری تا کل ورکفلوهایت از داخل ایران و با صورتحساب تومانی اجرا شوند.
راهاندازی در چند دقیقه
- 01
ساخت حساب و دریافت کلید 1xAi
در 1xai.ir ثبتنام و ایمیلت را تأیید کن. هدیهٔ ۱۰۰٬۰۰۰ تومانی پس از ثبتنام با یک کلیک از داشبورد دریافت میشود. سپس از داشبورد یک کلید 1xai-* بساز و همان لحظه یک نسخه از آن کپی کن — کلید فقط یک بار نمایش داده میشود.
- 02
ساخت Credential جدید از نوع OpenAI
در n8n به بخش Credentials برو، Create Credential را بزن و نوع OpenAI را انتخاب کن.
- 03
وارد کردن کلید و Base URL
در فیلد API Key کلید 1xai-* را بگذار و فیلد Base URL را به https://1xai.ir/v1 تغییر بده. سپس ذخیره کن.
- 04
انتخاب Credential در نودها
در نود OpenAI یا نودهای AI Agent / Basic LLM Chain، همین Credential را انتخاب کن و نام مدل را بنویس — مثلاً gpt-4o-mini برای اتوماسیونهای پرتکرار.
- 05
اجرای آزمایشی ورکفلو
یک اجرای تستی بگیر. هزینهٔ تومانی هر تماس بلافاصله در گزارش مصرف داشبورد 1xAi ثبت میشود و میتوانی مصرف هر ورکفلو را با کلید جداگانه تفکیک کنی.
تنظیمات آماده برای کپی
; n8n → Credentials → Create Credential → OpenAI
API Key = 1xai-XXXXXXXXXXXXXXXX
Base URL = https://1xai.ir/v1
; در نودها نام مدل را مینویسی — مسیریابی با نام مدل است:
; gpt-4o-mini → OpenAI
; claude-haiku-4-5 → Anthropic
; gemini-2.5-flash → Googleمدل پیشنهادی و هزینه
پیشنهاد: gpt-4o-mini — و برای هزینهٔ کمتر: gemini-2.5-flash
اتوماسیونها معمولاً پرتکرارند؛ مدلهای سبک مثل gpt-4o-mini یا gemini-2.5-flash هزینهٔ هر اجرا را حداقلی نگه میدارند. فقط برای گامهای پیچیده (تحلیل، تولید متن بلند) مدل قویتری مثل gpt-5 بگذار.
هزینهٔ تقریبی به حجم توکن مصرفیات بستگی دارد: قیمت تومانی هر مدل، قیمت لیست سرویسدهنده بهعلاوهٔ مارکآپ ثابت ۲۰٪ است و نرخ دلار هر روز ساعت ۰۹:۰۰ بهوقت تهران بهصورت خودکار با بازار همگام میشود. عدد دقیق برای مصرف خودت را در محاسبهگر هزینه ببین.
اگر کار نکرد
- فهرست کشویی مدلها لود نمیشود
- نام مدل را دستی وارد کن. n8n فهرست را از /v1/models میخواند و اگر لحظهای در دسترس نبود، وارد کردن دستی نام مدل کاملاً کافی است.
- برای هر ورکفلو یک کلید جدا بساز
- از داشبورد میتوانی چند کلید با نام و حتی سقف هزینهٔ جداگانه صادر کنی؛ اینطوری مصرف هر اتوماسیون شفاف است و یک ورکفلوی خطادار نمیتواند کل موجودی را مصرف کند.
- 401 — کلید نامعتبر
- کلید اشتباه است، منقضی شده یا باطلش کردهای. کلید را دوباره از داشبورد کپی کن یا یک کلید تازه بساز. فاصله یا خط جدیدِ اضافی هنگام paste رایجترین علت این خطاست.
- 402 — موجودی کافی نیست
- اعتبار تومانی حسابت تمام شده. حداقل شارژ ۱۰۰٬۰۰۰ تومان از طریق زرینپال است و بلافاصله پس از پرداختِ موفق، تماسهای بعدی کار میکنند. شارژ حساب ←
- خطای نام مدل / مسیریابی
- 1xAi بر اساس نام مدل مسیریابی میکند: claude-* به Anthropic، gemini-* به Google، deepseek-* به DeepSeek و بقیهٔ نامها به OpenAI میروند. نام مدل را دقیقاً از صفحهٔ مدلها کپی کن — یک حرف اشتباه یعنی خطای مدلِ ناشناخته. فهرست مدلها و قیمت تومانی ←
با اعتبار هدیهٔ ۱۰۰٬۰۰۰ تومانی شروع کن
هدیه پس از ثبتنام با یک کلیک از داشبورد دریافت میشود — بدون ویپیان و بدون کارت ارزی؛ حداقل شارژ بعدی ۱۰۰٬۰۰۰ تومان از طریق زرینپال است.
کدام نودهای n8n با این Credential کار میکنند؟
هر نودی که Credential از نوع OpenAI میپذیرد — نود OpenAI، AI Agent، Basic LLM Chain و سایر نودهای مبتنی بر مدل زبانی. چون 1xAi با API سازگار OpenAI ارائه میشود، از دید n8n هیچ فرقی با OpenAI رسمی ندارد.
برای اتوماسیون پرحجم چه مدلی صرفه دارد؟
مدلهای سبک مثل gpt-4o-mini یا gemini-2.5-flash برای طبقهبندی، خلاصهسازی و پاسخهای کوتاه معمولاً کافیاند و هزینه را حداقلی نگه میدارند. قیمتها قیمت لیست سرویسدهنده بهعلاوهٔ ۲۰٪ است؛ هزینهٔ ماهانهٔ مصرف خودت را با محاسبهگر 1xAi برآورد کن.
- مدلها و قیمت تومانی
فهرست کامل مدلها با نرخ لحظهای هر ۱ میلیون توکن
- محاسبهگر هزینه
برآورد هزینهٔ ماهانه بر پایهٔ مصرف واقعی خودت
- خرید API هوش مصنوعی
شروع کار با کلید بومی و پرداخت تومانی
- مستندات کامل
مرجع API، مسیرهای نیتیو، استریم و کدهای خطا
- وضعیت سرویس
سلامت لحظهای اتصال به هر سرویسدهنده