!Banner image

n8n-nodes-gemini-ai

n8n community node for Google Gemini AI integration

Version 0.6.7 - Critical TTS Fix

$3

- Critical TTS Structure Fix: תיקון מבנה הבקשה לפי הדוקומנטציה הרשמית החדשה של Google
- Fixed Request Format: שינוי מבנה speechConfig לפי הפורמט הנכון של Gemini API
- Stable Audio Generation: TTS אמור לעבוד כעת בצורה מושלמת

$3

- Correct speechConfig Structure: שימוש במבנה הנכון speechConfig.voiceConfig.prebuiltVoiceConfig
- Proper responseModalities: שימוש ב-["AUDIO"] במקום ["audio"]
- Removed Extra model Field: הסרת שדה model מיותר מגוף הבקשה

$3

- 0.6.6: תיקון המרת PCM ל-WAV + WAV header
- 0.6.5: שיפור טיפול בשגיאות TTS ועיצוב SVG חדש
- 0.6.4: הוספת 30 קולות + מודלים חדשים + מחיקת יצירת תמונות

תכונות

✅ יצירת טקסט - שליחת שאילתות טקסט ל-Gemini AI עם מודלים מתקדמים
✅ העלאת קבצים - העלאת קבצים באמצעות binary data מנודים קודמים
✅ ניתוח קבצים - ניתוח תמונות, אודיו, PDF ועוד באמצעות AI
✅ יצירת TTS - המרת טקסט לקול באיכות גבוהה עם 30 קולות שונים
✅ תמיכה בפורמטים מרובים - אודיו (MP3, WAV, OGG, OGA), תמונות (JPEG, PNG), PDF, וידאו ועוד
✅ העבודה עם זרימות n8n - קבלת קבצים מנודים קודמים ללא צורך בנתיבים
✅ מודלים מתקדמים - תמיכה במודלים החדשים של Gemini 2.5 ו-2.0

התקנה

``bash
npm install n8n-nodes-gemini-ai
`

או חיפוש ב-n8n Community Nodes:
n8n-nodes-gemini-ai

הגדרה

1. צור מפתח API ב-Google AI Studio
2. ב-n8n, הוסף את ה-Credentials החדש: "Gemini API"
3. הזן את ה-API Key שיצרת

שימוש

$3

פעולה בסיסית לשליחת שאילתות טקסט ל-Gemini AI.

פרמטרים:
- Prompt - השאילתה הראשית
- System Prompt - הוראות מערכת (אופציונלי)
- Model - בחירת מודל Gemini:
- Gemini 2.5 Flash Preview - מודל מתקדם עם חשיבה דינמית
- Gemini 2.5 Pro Preview - חשיבה מתקדמת והבנה מולטימדיה משופרת
- Gemini 2.0 Flash - תכונות דור הבא, מהירות וזמן אמת
- Gemini 2.0 Flash-Lite - חסכוני עם זמן אחזור קצר
- Gemini 1.5 Flash - מהיר ויעיל
- Gemini 1.5 Flash-8B - למשימות בנפח גבוה עם אינטליגנציה נמוכה יותר
- Gemini 1.5 Pro - למשימות מורכבות הדורשות יותר אינטליגנציה
- Temperature - רמת היצירתיות (0-2)
- Max Output Tokens - מספר מקסימלי של מילים בתגובה
- Response Format - פורמט התגובה (Text/JSON)

$3

מעלה קבצים מנודים קודמים ל-Gemini Files API.

שימוש:
1. השתמש בנוד שמייצר קובץ בינארי (כמו "Read Binary File", "HTTP Request", "Google Drive" וכו')
2. חבר את הנוד הזה אחרי הנוד שיצר את הקובץ
3. בחר את שם ה-Binary Property (בדרך כלל "data")
4. הזן שם תצוגה לקובץ (אופציונלי)

פרמטרים:
- Binary Property - שם המאפיין הבינארי (בדרך כלל "data")
- Display Name - שם לתצוגה בGemini (אופציונלי, יחזור לשם הקובץ המקורי)

פלט:
- fileUri - URI של הקובץ המועלה (לשימוש בפעולת ניתוח)
- fileName - שם הקובץ
- mimeType - סוג הקובץ
- sizeBytes - גודל הקובץ

$3

מנתח קבצים שהועלו עם Gemini AI.

פרמטרים:
- File URI - URI של הקובץ (מפעולת ההעלאה)
- File MIME Type - סוג הקובץ (שדה חופשי לכתיבה - תוכל להזין כל MIME type)
- Prompt - מה תרצה לדעת על הקובץ
- Model - מודל Gemini לניתוח (כל המודלים הזמינים כמו ביצירת טקסט)

סוגי קבצים נתמכים:
- אודיו: MP3, WAV, OGG, OGA
- תמונות: JPEG, PNG
- מסמכים: PDF
- וידאו: MP4, MOV
- אחר: קבצים נוספים

$3

המרת טקסט לאודיו באיכות גבוהה עם 30 קולות שונים.

פרמטרים:
- Text to Speak - הטקסט שתרצה להמיר לקול (תוכל לכלול הנחיות סגנון כמו "Say cheerfully:")
- TTS Model - בחירת מודל TTS:
- Gemini 2.5 Flash Preview TTS - מהיר עם זמן אחזור קצר
- Gemini 2.5 Pro Preview TTS - איכות גבוהה עם שליטה משופרת
- Voice - בחירת הקול מתוך 30 אפשרויות:
- Zephyr (Bright), Puck (Upbeat), Charon (Informative)
- Kore (Firm), Fenrir (Enthusiastic), Leda (Young)
- Orus (Friendly), Aoede (Breezy), Callirrhoe (Light)
- Autonoe (Bright), Enceladus (Breathy), Iapetus (Clear)
- Umbriel (Calm), Algieba (Smooth), Despina (Smooth)
- Erinome (Clean), Algenib (Gravelly), Rasalgethi (Informative)
- Laomedeia (Upbeat), Achernar (Soft), Alnilam (Firm)
- Schedar (Even), Gacrux (Mature), Pulcherrima (Expressive)
- Achird (Friendly), Zubenelgenubi (Casual), Vindemiatrix (Gentle)
- Sadachbia (Energetic), Sadaltager (Expert), Sulafat (Warm)

פלט:
- Binary Audio File - קובץ אודיו בפורמט WAV
- Metadata - מידע על המודל, הקול וגודל הקובץ

דוגמאות זרימות עבודה

$3


`
Read Binary File → Upload File → Analyze File
`

$3

`
HTTP Request (download audio) → Upload File → Analyze File
`

$3

`
Google Drive (download PDF) → Upload File → Analyze File
`

$3

`
HTTP Request (binary=true) → Upload File → Analyze File
`

$3

`
Manual Trigger → Gemini (Generate TTS) → Write Binary File
`

$3

`
Manual Trigger → Gemini (Generate TTS) → Gemini (Upload File) → Gemini (Analyze File)
`

הערות טכניות

- מגבלות גודל: עד 20MB לקובץ (מגבלת Google)
- זמן תפוגה: קבצים נמחקים אוטומטית אחרי 48 שעות
- עלויות: חיוב לפי גודל הקובץ ומורכבות הניתוח
- זמן עיבוד: קבצים גדולים יכולים לקחת יותר זמן
- Binary Data: הנוד מצפה לקבל קבצים בפורמט binary מנודים קודמים
- TTS: נוצר אודיו בפורמט WAV באיכות גבוהה עם תמיכה ב-30 קולות שונים
- מודלים מתקדמים: תמיכה מלאה במודלים החדשים של Gemini 2.5 ו-2.0

דוגמאות ספציפיות

$3

Prompt לניתוח: "תמלל את השיחה הזו ותן לי סיכום של הנקודות העיקריות"

$3

Prompt לניתוח: "תאר את התמונה הזו ותן התרעות על ממצאים חשובים"

$3

Prompt לניתוח: "תן לי סיכום של 3 נקודות עיקריות במסמך הזה"

$3

Text to Speak: "Say cheerfully: Have a wonderful day!"
TTS Model: Gemini 2.5 Flash Preview TTS
Voice: Kore (Firm)

$3

Text to Speak: "Say in a spooky whisper: By the pricking of my thumbs... Something wicked this way comes"
Voice: Umbriel (Calm)

תמיכה וקישורים

- GitHub Repository
- NPM Package
- Google Gemini API Documentation
- n8n Community

רישיון

MIT License

🛠️ פיתוח

$3

`bash
git clone
cd n8n-nodes-gemini-ai
npm install
npm run dev # עבור watching mode
`

$3

`bash
npm run build
`

$3

`bash
npm run lint
npm run lintfix # תיקון אוטומטי
`

$3

`bash
npm run format
`

🔍 פתרון בעיות

$3

#### "API Key not found"
- ודא שיצרת credential עם API Key תקין
- בדק שה-credential מחובר לנוד

#### "Model not found"
- ודא שאתה משתמש במודל תקין
- בדק שה-API Key שלך תומך במודל הנבחר

#### "Rate limit exceeded"
- המתן מספר דקות לפני ניסיון חוזר
- בדק את ה-quota ב-Google Cloud Console

#### "Invalid response format"
- ודא שהפרומפט תקין
- בדק שלא חורגים ממגבלות הטוקנים

📋 API Reference

$3

- Base URL: https://generativelanguage.googleapis.com/v1beta
- Generate Content: /models/{model}:generateContent

$3

מודלי טקסט וניתוח קבצים:
- gemini-2.5-flash-preview-05-20 - מודל מתקדם עם חשיבה דינמית
- gemini-2.5-pro-preview-05-06 - חשיבה מתקדמת והבנה מולטימדיה משופרת
- gemini-2.0-flash - תכונות דור הבא, מהירות וזמן אמת
- gemini-2.0-flash-lite - חסכוני עם זמן אחזור קצר
- gemini-1.5-flash - מהיר ויעיל
- gemini-1.5-flash-8b - למשימות בנפח גבוה עם אינטליגנציה נמוכה יותר
- gemini-1.5-pro - למשימות מורכבות הדורשות יותר אינטליגנציה

מודלי TTS:
- gemini-2.5-flash-preview-tts - מהיר עם זמן אחזור קצר
- gemini-2.5-pro-preview-tts - איכות גבוהה עם שליטה משופרת

🤝 תרומה

מוזמנים לתרום לפרויקט!

1. Fork את הפרויקט
2. צרו branch חדש (git checkout -b feature/amazing-feature)
3. Commit השינויים (git commit -m 'Add amazing feature')
4. Push ל-branch (git push origin feature/amazing-feature`)
5. פתחו Pull Request

📝 רישיון

MIT License - ראו קובץ LICENSE לפרטים

🔗 קישורים

- Google Gemini API Documentation
- n8n Community Nodes Documentation
- Google AI Studio

📞 תמיכה

יש בעיה? פתחו issue ב-GitHub או צרו קשר דרך:
- GitHub Issues: פתח issue
- Email: your.email@example.com

---

נוצר עם ❤️ עבור קהילת n8n