اوپنایآی
OpenAI
هوش مصنوعی GPT-4o، تولید تصویر DALL-E 3، گفتار به متن Whisper
نمای کلی
نود OpenAI یکی از هیجانانگیزترین نودهای n8n است که قدرت هوش مصنوعی را به workflowهای شما اضافه میکند.
قابلیتهای کلیدی:
- چت با GPT-4o، GPT-4 و GPT-3.5
- تولید تصویر با DALL-E 3
- تبدیل گفتار به متن با Whisper
- تبدیل متن به گفتار (TTS)
- Embeddings برای جستجوی معنایی
- تحلیل تصویر (Vision)
- Function Calling
- JSON Mode (خروجی ساختاریافته)
مدلهای موجود:
- GPT-4o: سریعترین و بهترین مدل (متن + تصویر)
- GPT-4o-mini: ارزان و سریع برای کارهای ساده
- GPT-4 Turbo: قدرتمند با context بلند (128K)
- GPT-3.5 Turbo: ارزان برای کارهای عمومی
- DALL-E 3: تولید تصویر باکیفیت
- Whisper: تبدیل صدا به متن (پشتیبانی از فارسی)
- TTS-1/TTS-1-HD: متن به گفتار
کاربردها:
- چتبات پشتیبانی هوشمند
- تولید محتوای وبلاگ و شبکههای اجتماعی
- ترجمه خودکار
- خلاصهسازی متن و ایمیل
- تحلیل احساسات نظرات مشتریان
- پاسخ خودکار به ایمیل
- تولید کد و اسکریپت
- طبقهبندی و دستهبندی خودکار
احراز هویت
احراز هویت OpenAI
دریافت API Key:
- 1به [platform.openai.com](https://platform.openai.com) بروید
- 2ثبتنام یا ورود کنید
- 3به API Keys بروید
- 4Create new secret key کلیک کنید
- 5نام دلخواه بگذارید (مثل "n8n-automation")
- 6کلید تولید شده را فوراً کپی کنید (فقط یک بار نمایش داده میشود)
تنظیم در n8n:
- 1Credentials > OpenAI API
- 2API Key وارد کنید
- 3Organization ID (اختیاری): اگر چند سازمان دارید
- 4Test Connection بزنید
شارژ اکانت:
- 1به Billing > Payment methods بروید
- 2کارت بانکی اضافه کنید
- 3Add to credit balance بزنید
- 4حداقل 5 دلار شارژ کنید
تنظیم محدودیت هزینه:
- 1Billing > Usage limits
- 2Hard limit: حداکثر هزینه ماهانه
- 3Soft limit: هشدار ایمیلی
قیمتهای تقریبی (هر 1 میلیون توکن):
GPT-4o: $2.50 ورودی / $10 خروجی
GPT-4o-mini: $0.15 ورودی / $0.60 خروجی
GPT-4 Turbo: $10 ورودی / $30 خروجی
GPT-3.5: $0.50 ورودی / $1.50 خروجی
DALL-E 3: $0.04 - $0.12 per image
Whisper: $0.006 per minute
TTS: $15 per 1M charactersنکات مهم:
- API Key را در جای امن نگه دارید
- از Organization ID برای مدیریت بهتر استفاده کنید
- Usage Limits تنظیم کنید تا هزینه کنترل شود
- Rate Limits: بسته به سطح اکانت متفاوت است
عملیاتهای موجود
chatCompletion
مکالمه با مدلهای GPT-4o، GPT-4، GPT-3.5
imageGeneration
ایجاد تصویر از توصیف متنی
audioTranscription
تبدیل فایل صوتی به متن
textToSpeech
تبدیل متن به فایل صوتی
embedding
تبدیل متن به بردار عددی برای جستجوی معنایی
vision
تحلیل و توصیف تصویر با GPT-4o
کاربردهای متداول
1. چتبات پشتیبانی هوشمند
پاسخ به سوالات مشتریان:
Telegram Trigger (پیام کاربر)
→ OpenAI (Chat)
Model: gpt-4o-mini
System: "تو یک پشتیبان فارسیزبان فروشگاه آنلاین هستی.
فقط به سوالات مربوط به محصولات و سفارشات پاسخ بده.
اگر سوال فنی بود، به تیم پشتیبانی ارجاع بده."
User: {{$json.message}}
Temperature: 0.3
→ Telegram (ارسال پاسخ)2. خلاصهسازی ایمیل
خلاصه ایمیلهای بلند:
Gmail (Get All - unread)
→ OpenAI (Chat)
System: "ایمیل زیر را در 2-3 جمله فارسی خلاصه کن.
اگر اقدامی نیاز است، مشخص کن."
User: {{$json.body}}
Temperature: 0.2
MaxTokens: 200
→ Telegram (ارسال خلاصه)3. تحلیل احساسات نظرات
دستهبندی نظرات مشتریان:
MySQL (نظرات جدید)
→ OpenAI (Chat)
System: "نظر زیر را تحلیل کن. فقط JSON برگردان:
{sentiment: positive/negative/neutral, topics: [...], score: 1-5}"
User: {{$json.comment}}
ResponseFormat: json_object
Temperature: 0
→ Set (Parse JSON)
→ MySQL (ذخیره نتیجه)4. ترجمه خودکار
ترجمه محتوا:
Webhook (متن جدید)
→ OpenAI (Chat)
System: "متن فارسی زیر را به انگلیسی روان ترجمه کن.
لحن رسمی و حرفهای داشته باش."
User: {{$json.text}}
Temperature: 0.3
→ MySQL (ذخیره ترجمه)5. تولید محتوای شبکههای اجتماعی
تولید پست اینستاگرام:
Schedule (هر روز ساعت 10)
→ MySQL (محصول روز)
→ OpenAI (Chat)
System: "یک کپشن فارسی جذاب برای اینستاگرام بنویس.
شامل: توصیف محصول، مزایا، قیمت، هشتگها.
لحن: دوستانه و حرفهای. حداکثر 300 کلمه."
User: محصول: {{$json.name}}
قیمت: {{$json.price}} تومان
ویژگیها: {{$json.features}}
→ Telegram (ارسال برای تایید ادمین)6. تولید تصویر محصول
ساخت تصویر با DALL-E:
Webhook (درخواست تصویر)
→ OpenAI (Image Generation)
Model: dall-e-3
Prompt: "Professional product photo of {{$json.product}},
clean white background, studio lighting, 4K quality"
Size: 1024x1024
Quality: hd
→ Google Drive (آپلود تصویر)7. تبدیل صدا به متن
رونویسی جلسات:
Webhook (فایل صوتی)
→ OpenAI (Whisper)
Language: fa
Prompt: "جلسه تیم فنی درباره محصول جدید"
→ OpenAI (Chat)
System: "متن جلسه زیر را خلاصه کن:
1. موضوعات مطرح شده
2. تصمیمات گرفته شده
3. اقدامات بعدی"
User: {{$json.text}}
→ Google Drive (ذخیره خلاصه)8. طبقهبندی تیکتها
دستهبندی خودکار تیکتهای پشتیبانی:
Webhook (تیکت جدید)
→ OpenAI (Chat)
System: "تیکت زیر را بررسی کن. JSON برگردان:
{
department: فنی/مالی/فروش/عمومی,
priority: low/medium/high/critical,
summary: خلاصه 1 جملهای,
suggestedResponse: پیشنهاد پاسخ
}"
ResponseFormat: json_object
Temperature: 0
→ MySQL (ذخیره دستهبندی)
→ IF (priority = critical)
→ Telegram (هشدار فوری)9. بررسی SEO محتوا
تحلیل و بهبود محتوای وب:
Webhook (محتوای جدید)
→ OpenAI (Chat)
System: "محتوای زیر را از نظر SEO بررسی کن:
1. عنوانها
2. کلمات کلیدی
3. طول محتوا
4. پیشنهاد بهبود
به فارسی پاسخ بده."
Temperature: 0.3
→ Gmail (ارسال گزارش SEO)10. پاسخ خودکار به ایمیل
پیشنویس پاسخ ایمیل:
Gmail Trigger (ایمیل جدید)
→ OpenAI (Chat)
System: "یک پاسخ حرفهای فارسی به این ایمیل بنویس.
لحن: رسمی و مودبانه.
اگر اطلاعات کافی نداری، بخواه توضیح بیشتر بدن."
User: "فرستنده: {{$json.from}}
موضوع: {{$json.subject}}
متن: {{$json.body}}"
Temperature: 0.5
→ Gmail (ذخیره Draft)نکات حرفهای
نکات حرفهای
- 1System Message مؤثر: بهترین نتایج با prompt دقیق:
// بد:
"به سوالات پاسخ بده"
// خوب:
"تو یک متخصص پشتیبانی فروشگاه الکترونیک هستی.
- فقط به فارسی پاسخ بده
- پاسخها کوتاه و مفید باشند (حداکثر 100 کلمه)
- اگر سوال خارج از حوزه بود، بگو نمیدانی
- لحن: دوستانه و حرفهای
- قیمتها به تومان باشند"- 1Temperature Guide:
0.0: پاسخ دقیق و یکسان (طبقهبندی، استخراج داده)
0.3: پاسخ دقیق با کمی تنوع (ترجمه، خلاصه)
0.7: پاسخ خلاقانه (تولید محتوا)
1.0: پاسخ بسیار خلاقانه (داستان، شعر)- 1JSON Mode: خروجی ساختاریافته:
Response Format: json_object
System: "خروجی را فقط JSON برگردان:
{name: string, category: string, score: number}"- 1Token Management: کنترل هزینه:
// هر کلمه فارسی ≈ 3-5 توکن
// هر کلمه انگلیسی ≈ 1-2 توکن
// 1000 توکن ≈ 200 کلمه فارسی
MaxTokens: 500 // محدود کردن پاسخ- 1Few-shot Learning: آموزش با مثال:
System: "نظرات را تحلیل کن.
مثال 1: 'محصول عالی بود' → positive
مثال 2: 'تحویل دیر شد' → negative
مثال 3: 'معمولی بود' → neutral"- 1Conversation History: حافظه مکالمه:
Messages: [
{role: "system", content: "..."},
{role: "user", content: "سلام"},
{role: "assistant", content: "سلام! چطور میتونم کمکتون کنم؟"},
{role: "user", content: "{{$json.newMessage}}"}
]- 1مدل مناسب انتخاب کنید:
کار ساده (طبقهبندی، خلاصه): gpt-4o-mini
کار پیچیده (تحلیل، کد): gpt-4o
تصویر: dall-e-3
صدا: whisper-1- 1Streaming: برای چتبات Real-time از Streaming استفاده کنید.
- 1Content Filtering: OpenAI محتوای نامناسب را فیلتر میکند. در System Message بنویسید:
"اگر سوال نامناسب بود، مودبانه بگو نمیتوانی پاسخ بدهی."- 1Retry on Error: برای Rate Limit:
OpenAI → Error → Wait (5 seconds) → OpenAI (Retry)- 1Caching: پاسخهای تکراری را کش کنید:
Webhook → MongoDB (Check Cache)
→ IF (Cache hit) → Return cached
→ IF (Cache miss) → OpenAI → MongoDB (Save) → Return- 1بهینهسازی Prompt فارسی:
// نکته: GPT فارسی را خوب میفهمد
// ولی Prompt انگلیسی دقت بیشتری دارد
// راهحل: System Message انگلیسی + User Message فارسی
System: "You are a customer support assistant.
Always respond in Persian (Farsi).
Be polite and professional."
User: "سفارش من کجاست؟"- 1Function Calling: ارتباط AI با ابزارها:
// AI تصمیم میگیرد کدام تابع فراخوانی شود
Functions: [
{name: "getOrder", description: "وضعیت سفارش"},
{name: "createTicket", description: "ثبت تیکت"}
]- 1Vision (تحلیل تصویر):
// بررسی عکس رسید پرداخت
System: "عکس رسید بانکی را بررسی کن. JSON برگردان:
{amount, date, trackingCode, bankName}"
Image: URL رسید- 1مدیریت هزینه:
- از gpt-4o-mini برای کارهای ساده استفاده کنید (10x ارزانتر)
- MaxTokens محدود کنید
- Cache پاسخهای تکراری
- Usage Dashboard مانیتور کنید
رفع مشکلات
خطاهای رایج
1. خطای "Incorrect API key" (401)
علت: API Key اشتباه یا غیرفعال
راهحل
- API Key را از platform.openai.com چک کنید
- کلید جدید بسازید اگر لازم است
- مطمئن شوید کلید کامل کپی شده (شروع با
sk-)
2. خطای "Insufficient quota" (429)
علت: اعتبار تمام شده
راهحل
- Billing > Overview: مانده اعتبار را بررسی کنید
- اعتبار شارژ کنید ($5 حداقل)
- Usage Limits بررسی کنید
- اگر Free Tier: باید شارژ کنید
3. خطای "Rate limit reached"
علت: تعداد درخواست بیش از حد مجاز
راهحل
- بین درخواستها Wait اضافه کنید
- از مدل ارزانتر استفاده کنید (gpt-4o-mini)
- Batch Size کاهش دهید
- Rate Limits:
- Tier 1: 500 RPM / 30,000 TPM
- Tier 2: 5,000 RPM / 450,000 TPM
4. خطای "Context length exceeded"
علت: متن ورودی خیلی بلند
راهحل
- متن را خلاصه یا برش بزنید
- از مدل با context بیشتر استفاده کنید:
- GPT-4o: 128K tokens
- GPT-3.5: 16K tokens
- محتوا را تکهتکه ارسال کنید
5. پاسخ نامربوط
علت: System Message ضعیف
راهحل
- System Message دقیقتر بنویسید
- Temperature کاهش دهید (0.2-0.3)
- مثالهایی در System Message اضافه کنید
- از JSON Mode استفاده کنید
6. خطای "Invalid image"
علت: فرمت تصویر پشتیبانی نمیشود
راهحل
- فرمتهای مجاز: PNG, JPEG, GIF, WEBP
- حداکثر حجم: 20MB
- URL تصویر باید عمومی باشد
7. Whisper دقیق نیست
علت: کیفیت صدا پایین
راهحل
- زبان را مشخص کنید:
language: 'fa' - Prompt راهنما اضافه کنید
- فرمتهای بهتر: mp3, wav
- نویز پسزمینه کاهش دهید
