اتصال n8n به هوش مصنوعی 1ai؛ اعتبارنامهی OpenAI با Base URL سفارشی
n8n ابزار ساخت گردش‌کار خودکار است و گره‌های هوش مصنوعی آن با اعتبارنامهی OpenAI کار می‌کنند. همین اعتبارنامه فیلد Base URL دارد؛ کافی است آن را `https://1ai.ir/v1` بگذارید تا گره‌های OpenAI Chat Model، AI Agent و Embeddings با مدلهای وان ای آی (1ai) کار کنند. اعتبار را با پرداخت ریالی می‌خرید و برای کلید هر گردش‌کار سقف مصرف می‌گذارید. در این راهنما تنظیم دقیق، یک تنظیم ضروری که پیش‌فرضش در n8n روشن است، و یک نمونه‌ی گردش‌کار واقعی را می‌بینید.
چرا با 1ai
بدون کدنویسی
اتصال با یک اعتبارنامه در رابط n8n انجام میشود و همه‌ی گره‌های OpenAI از آن استفاده می‌کنند.
هر گره، مدل خودش
برای دستهبندی ساده یک مدل ارزان و برای AI Agent یک مدل قوی بگذارید؛ همه با یک کلید 1ai.
پرداخت ریالی
هزینه‌ی هر اجرای گردش‌کار به اندازه‌ی توکن‌ها از اعتبار 1ai کم میشود که با پرداخت ریالی شارژ میشود.
کلید جدا برای هر گردش‌کار
برای هر گردش‌کار کلید با سقف ماهانه بسازید تا یک حلقه‌ی اشتباه یا هجوم درخواست، کل اعتبار را خرج نکند.
لاگ درخواست‌ها
در پنل توسعه‌دهنده می‌بینید هر کلید چقدر مصرف کرده و کدام اجرا خطا داده است.
در چند قدم
- ۱
کلید API بسازید
در پنل 1ai از بخش توسعه‌دهندگان ← کلیدها یک کلید با نام همان گردش‌کار و سقف ماهانه بسازید.
- ۲
اعتبارنامهی OpenAI بسازید
در n8n یک Credential از نوع OpenAI بسازید، کلید را در API Key و `https://1ai.ir/v1` را در Base URL بگذارید و ذخیره کنید.
- ۳
گره مدل را وصل کنید
به AI Agent یا Basic LLM Chain یک OpenAI Chat Model وصل کنید، همان اعتبارنامه و یک مدل را انتخاب کنید.
- ۴
Responses API را خاموش کنید
در OpenAI Chat Model گزینه‌ی Use Responses API را خاموش کنید و گردش‌کار را یک بار آزمایشی اجرا کنید.
مدلهای مناسب AI Agent در n8n
همه‌ی مدل‌هاGPT-6.1 Sol
پرچم‌دار اوپن‌ای‌آی برای کارهای دقیق، تحلیلی و چندمرحلهای
Gemini 3.8 Flash
سریع، چندوجهی و با حافظه‌ی متنی بسیار بلند
Claude Haiku 5.5
سریع‌ترین کلود؛ در سهمیه‌ی رایگان روزانه
سبک و ارزان؛ در سهمیه‌ی رایگان روزانه
DeepSeek V4.1 Flash
سریع و بسیار ارزان؛ در سهمیه‌ی رایگان روزانه
نمونه پرامپت‌ها
پرامپت را کپی کنید، در 1ai بگذارید و جزئیات خودتان را جایگزین کنید.
خلاصه و دستهبندی فرم
Summarise this form submission in Persian in three bullet points, then classify it as sales, support or other. Return JSON with the keys summary and category. Name: {{ $json.name }} Message: {{ $json.message }}
عبارت‌های {{ }} را با نام فیلدهای فرم خودتان عوض کنید.
پیش‌نویس پاسخ به مشتری
You are the support assistant of [نام کسب‌وکار]. Draft a short, polite Persian reply to this customer message. Do not promise refunds or delivery dates. Message: {{ $json.text }}
دستهبندی ایمیل
Classify this email as invoice, complaint, question or spam. Answer with one word only. Subject: {{ $json.subject }} Body: {{ $json.text }}
پیام سیستم ربات تلگرام
You are a helpful Persian assistant for [موضوع کسب‌وکار]. Answer briefly and politely. If the user asks about an order, call the [نام ابزار] tool with the order number before answering.
این متن را در System Message گره AI Agent بگذارید.
استخراج داده
Extract the product name, quantity and city from this message and return JSON only, in this shape: {"product": "", "quantity": 0, "city": ""} Message: {{ $json.message }}
n8n چیست و چرا با 1ai؟
n8n گره‌ها را به هم وصل میکند تا کاری مثل «هر فرم تازه را خلاصه کن و به تیم خبر بده» خودکار شود. گره‌های هوش مصنوعی آن، مثل AI Agent و Basic LLM Chain، مدل را از یک گره جانبی به نام OpenAI Chat Model می‌گیرند. 1ai همان API را با شکل OpenAI، با پرداخت ریالی و با سقف مصرف برای هر کلید میدهد؛ توضیح کلی در صفحهی توسعه‌دهندگان آمده است.
پیش‌نیازها:
- n8n روی سرور خودتان یا n8n Cloud؛ سرور باید به
https://1ai.irدسترسی داشته باشد - حساب 1ai با اعتبار و یک کلید
sk-1ai-… - شناسه‌ی مدل با پیشوند سازنده، از مدلهای گفتگو
ساخت اعتبارنامهی OpenAI برای 1ai در n8n
از بخش Credentials یک اعتبارنامهی تازه از نوع OpenAI بسازید:
| فیلد | مقدار |
|---|---|
| API Key | کلید sk-1ai-… |
| Organization ID (optional) | خالی |
| Base URL | https://1ai.ir/v1 |
| Add Custom Header | خاموش |
موقع ذخیره، n8n برای آزمایش اعتبارنامه نشانی /models را صدا می‌زند؛ اگر پیام موفقیت دیدید، کلید و آدرس درست است. همین اعتبارنامه برای گره Embeddings OpenAI هم کار میکند؛ برای بردارسازی متن مدل openai/text-embedding-3-small را انتخاب کنید.
تنظیم گره OpenAI Chat Model و AI Agent
- Credential: اعتبارنامه‌ای که برای 1ai ساختید.
- Model: در حالت From List، n8n برای آدرس‌های سفارشی همه‌ی مدلهای
/v1/modelsرا نشان میدهد، از جمله مدلهای تصویر و بردار؛ یک مدل چت انتخاب کنید. در حالت ID هم می‌توانید شناسه را دستی بنویسید، مثلopenai/gpt-5.4-mini. - Use Responses API: خاموش. در نسخه‌های تازه‌ی گره این گزینه پیش‌فرض روشن است و درخواست را به
/v1/responsesمیفرستد که 1ai ندارد. - Built-in Tools (Web Search، File Search، Code Interpreter) فقط با Responses API کار می‌کنند و این‌جا در دسترس نیستند؛ به جای آن‌ها گره‌های ابزار خود n8n را به AI Agent وصل کنید.
- Options: با Maximum Number of Tokens طول پاسخ و هزینه را محدود کنید و Timeout و Max Retries را برای گردشکارهای حساس تنظیم کنید.
AI Agent برای صدا زدن ابزارها به مدل دارای tools نیاز دارد، مثل anthropic/claude-sonnet-5.5، openai/gpt-6.1-sol یا google/gemini-3.8-flash. برای خلاصه و دستهبندی ساده، deepseek/deepseek-v4.1-flash کافی و ارزان است.
نمونه‌ی گردش‌کار: خلاصه‌ی فرم‌های تازه و ربات تلگرام
خلاصه‌ی فرمها: n8n Form Trigger (یا Webhook) ← Basic LLM Chain با OpenAI Chat Model و پرامپت «خلاصه و دستهبندی فرم» از نمونه‌های بالا ← گره Send Email یا Google Sheets برای ثبت نتیجه.
ربات تلگرام: Telegram Trigger ← AI Agent با OpenAI Chat Model و Simple Memory ← گره Telegram با عمل Send Message. سرور n8n باید به API تلگرام دسترسی داشته باشد.
بدون گره هوش مصنوعی، با HTTP Request: روش POST، آدرس https://1ai.ir/v1/chat/completions، احراز هویت با Predefined Credential Type و همان اعتبارنامهی OpenAI، و بدنه‌ی JSON:
{
"model": "deepseek/deepseek-v4.1-flash",
"messages": [
{ "role": "user", "content": "Summarise in Persian: {{ $json.message }}" }
]
}پاسخ در {{ $json.choices[0].message.content }} است. اگر متن ورودی نقل‌قول یا خط تازه دارد، مقدار content را بدون نقل‌قول و به شکل {{ JSON.stringify('Summarise in Persian: ' + $json.message) }} بنویسید تا JSON خراب نشود. اگر به جای n8n در کد خودتان کار می‌کنید، راهنمای OpenAI SDK را ببینید.
خطاها، سقف درخواست و کنترل هزینه
- آزمایش اعتبارنامه رد میشود (401): کلید اشتباه یا باطل است، یا Base URL بدون
/v1نوشته شده. - 404 با پیام Unknown endpoint: گزینه‌ی Use Responses API روشن مانده است.
- 404
model_not_found: شناسه را با پیشوند سازنده بنویسید. - The service is receiving too many requests from you (429): سقف درخواست در دقیقه پر شده. طبق مستندات n8n داده را با Loop Over Items دسته‌دسته کنید و یک گره Wait بگذارید.
- 402: اعتبار یا سقف ماهانه‌ی کلید تمام شده است.
- همه‌ی آیتم‌ها یک جواب گرفتند: در گره‌های جانبی مثل OpenAI Chat Model، عبارت‌ها فقط آیتم اول را می‌خوانند؛ داده‌ی هر آیتم را در پرامپت گره اصلی بگذارید.
برای کنترل هزینه برای هر گردش‌کار کلید جدا با سقف ماهانه و مدلهای مجاز بسازید، کارهای ساده را به مدل ارزان بدهید و Maximum Number of Tokens را تعیین کنید. جزئیات در راهنمای کلیدها و کنترل هزینه و بسته‌های اعتبار در تعرفه‌ها آمده است.
ابزارهای آماده
خلاصه‌ساز متن
خلاصه‌ی دقیق مقاله، گزارش، جزوه یا صورت‌جلسه
پاسخ به پیام مشتری
جواب مؤدبانه و حرفه‌ای به دایرکت، نظر یا شکایت مشتری
دستیارهای مرتبط
تحلیل‌گر داده و SQL
کوئری SQL، فرمول اکسل، تحلیل و تفسیر داده
- «یک کوئری SQL بنویس که ۱۰ مشتری با بیشترین خرید در سه ماه اخیر را برگرداند»
- «در اکسل چطور فروش ماهانه را بر اساس دستهبندی جمع بزنم؟»
سوالات متداول
این تنظیم در n8n Cloud هم کار میکند؟
بله. فیلد Base URL در اعتبارنامهی OpenAI هم در n8n Cloud و هم در نسخهی روی سرور خودتان هست. https://1ai.ir/v1 آدرس عمومی است و از سرورهای n8n Cloud هم در دسترس است.
اگر Use Responses API را خاموش نکنم چه میشود؟
گره درخواست را به /v1/responses میفرستد و 1ai با خطای 404 و پیام Unknown endpoint جواب میدهد. با خاموش کردن این گزینه، گره از Chat Completions استفاده میکند که در 1ai کامل پشتیبانی میشود، از جمله استریم و فراخوانی ابزار.
کدام مدل برای گردشکارهای پرتکرار ارزانتر است؟
برای خلاصه، دستهبندی و استخراج داده، مدلهای سبک مثل deepseek/deepseek-v4.1-flash، openai/gpt-5.4-mini و google/gemini-3.8-flash معمولاً کافیاند. مدلهای قویتر را برای AI Agent و تصمیمهای چندمرحلهای نگه دارید. قیمت هر مدل در صفحهی همان مدل آمده است.
میتوانم در n8n با 1ai پایگاه دانش و جستوجوی معنایی بسازم؟
بله. گره Embeddings OpenAI را با همان اعتبارنامه و مدل openai/text-embedding-3-small به یک Vector Store وصل کنید و بعد AI Agent را با ابزار جستوجو در همان پایگاه به کار ببرید.
n8n من روی سروری در ایران است؛ مشکلی پیش میآید؟
برای اتصال به https://1ai.ir/v1 مشکلی نیست. فقط گرههایی که به سرویسهای خارجی مثل تلگرام یا گوگل وصل میشوند، به دسترسی سرور به همان سرویسها بستگی دارند.
اطلاعات فرمها و پیامها کجا میرود؟
متن هر درخواست به 1ai و از آنجا به سازندهی مدل انتخابی میرسد تا پاسخ ساخته شود. اطلاعات حساس مثل کد ملی یا شمارهی کارت را پیش از ارسال حذف یا ماسک کنید.
مطالب مرتبط
استفاده از API سازگار با OpenAI در 1ai: راهنمای عملی با Python، Node.js و cURL
چطور پروژه‌ای را که با کتابخانه‌ی OpenAI نوشته شده، فقط با تغییر آدرس پایه و کلید به 1ai وصل کنید؛ با نمونه کد Python، Node.js و cURL، استریم، فهرست مدل‌ها و مدیریت خطا.
کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه
چطور کلیدهای API را امن نگه دارید و هزینه را مهار کنید: مدلهای مجاز، سقف اعتبار ماهانه، محدودیت نرخ، تاریخ انقضا، کلیدهای تیمی و گزارش مصرف.
هوش مصنوعی برای کسب‌وکارهای کوچک و فروشگاه‌های اینترنتی
کاربردهای عملی هوش مصنوعی در کسب‌وکار کوچک و فروشگاه اینترنتی: توضیح محصول، پاسخ به مشتری، محتوای شبکه‌های اجتماعی، تصویر تبلیغاتی، تحلیل فروش و کار تیمی، با نکته‌های احتیاطی.
مدل زبانی بزرگ (LLM) چیست؟ راهنمای کاربردی برای فارسی
LLM موتور بسیاری از دستیارهای هوش مصنوعی است. با مثال‌های ساده، سازوکار آن، تفاوت مدلهای باز و بسته و روش انتخاب مدل مناسب برای متن و کارهای فارسی را بشناسید.
صفحه‌های مرتبط
همه‌ی امکاناتOpenAI SDK
کتابخانه‌ی رسمی openai را در Python و Node.js با تغییر آدرس پایه به 1ai وصل کنید و چت، فراخوانی ابزار، بردار متن، تصویر و صدا را از یک کلید بگیرید.
اتصال Open WebUI
Open WebUI را روی سرور خودتان بالا بیاورید، یک اتصال OpenAI با آدرس 1ai بسازید و برای کاربرانتان رابط چت با GPT، Claude، Gemini و DeepSeek داشته باشید.
برنامه‌نویسی با هوش مصنوعی
کد بنویسید، خطا پیدا کنید، SQL و Regex بسازید و با API سازگار با OpenAI مدل‌ها را به ابزارهای خودتان وصل کنید.
اتصال n8n به هوش مصنوعی 1ai؛ اعتبارنامهی OpenAI با Base URL سفارشی
در n8n یک اعتبارنامهی OpenAI با آدرس 1ai بسازید و در گردشکارهای خودکار، از AI Agent تا ربات تلگرام، با GPT، Claude، Gemini و DeepSeek کار کنید.
ساخت کلید API