MCP וחיבור ל-Claude · תמונות וסרטונים

Gemini API (תמונות ווידאו)

יוצרים תמונות Nano Banana וסרטוני Veo של Google מתוך Claude Code, עם מפתח רשמי ותקרת הוצאה

חברהGoogle דרכי חיבורAPI ישיר נבדק מול התיעוד30.09.2026

מה Claude יכול לעשות עם Gemini API (תמונות ווידאו)

Gemini API הוא הממשק הרשמי של Google ליצירת תמונות במשפחת Nano Banana ולסרטונים קצרים במשפחת Veo. אין לגוגל מחבר רשמי ל-Claude, ולכן מחברים אותו דרך Claude Code: מפתח מ-Google AI Studio, חיוב מראש ותקרת הוצאה, וסקריפט קטן עם הספרייה הרשמית google-genai שמציג מחיר ומחכה לאישור לפני כל יצירה.

רואה וקורא
  • אילו מודלים של תמונה (Nano Banana) ווידאו (Veo) זמינים כרגע למפתח ה-API שלכם
  • את התמונה או הקליפ שנוצרו באותה שיחה, כדי לערוך אותם עוד סבב
יכול לשנות ולשלוח
  • יצירת תמונה חדשה במודל Nano Banana שנבחר
  • עריכת תמונה קיימת, כמו החלפת רקע או שינוי פריט
  • יצירת קליפ וידאו קצר מטקסט במודל Veo

מה צריך לפני שמתחילים

  • חשבון Google. בכניסה הראשונה ל-Google AI Studio גוגל יוצרת לכם אוטומטית פרויקט ומפתח
  • אמצעי תשלום וטעינה מראש של 5 דולר לפחות. לפי דף התמחור של גוגל, למודלי התמונה והווידאו אין שכבה חינמית
  • אפליקציית Claude למחשב, Mac או Windows, עם לשונית Code. היא כלולה בתוכניות בתשלום, Pro ומעלה
  • כ-20 דקות, פעם אחת
מדריך החיבור

איך מחברים את Gemini API (תמונות ווידאו) ל-Claude.

הדרך הרשמית והיציבה היא Gemini API של גוגל, עם מפתח מ-Google AI Studio וספריית הפייתון הרשמית google-genai. אין לגוגל מחבר רשמי ל-Claude ליצירת תמונות, ולכן Claude Code בונה לכם סקריפט קטן שקורא ל-API, מתוך פרומפט אחד שמדביקים. לפני כן מגדירים חיוב ותקרת הוצאה חודשית ב-AI Studio, כי למודלי התמונה והווידאו אין שכבה חינמית. השרת הקהילתי nanobanana לא עודכן מאז מרץ 2026 ועדיין קורא לשמות מודלים שגוגל סגרה ב-25 ביוני 2026, ולכן כרגע לא ממליצים עליו.

0 מתוך 6 שלבים
  1. 1

    מוצאים את המפתח ב-Google AI Studio

    Google AI Studio הוא האתר של גוגל לעבודה עם Gemini API. משתמש חדש מקבל אוטומטית פרויקט ומפתח API אחרי שהוא מאשר את תנאי השימוש. נכנסים עם חשבון Google של העסק.

    1. פותחים את הקישור ונכנסים עם חשבון Google
    2. אם מופיעים תנאי שימוש, קוראים ומאשרים
    3. בטבלת API Keys מחפשים שורה עם מפתח ופרויקט. אם אין, לוחצים Create API key ובוחרים פרויקט
    4. אם ליד המפתח כתוב Unrestricted, מעבירים את העכבר על התווית, לוחצים Add restrictions, בוחרים Restrict to Gemini API only ולוחצים Restrict key
    איפה:https://aistudio.google.com/api-keys

    מאז 28 במאי 2026 מפתחות חדשים נוצרים כבר מוגבלים ל-Gemini API, ולכן ברוב המקרים הסעיף האחרון לא נדרש. מפתח עם התווית Unrestricted או Blocked לא יעבוד.

  2. 2

    מגדירים חיוב וטוענים קרדיט

    בלי חיוב פעיל אי אפשר ליצור תמונות. חשבונות חדשים עובדים בטעינה מראש (Prepay): קונים קרדיט של 5 דולר לפחות, וכל תמונה יורדת מהיתרה. כשהיתרה מגיעה לאפס כל המפתחות נעצרים, וזו גם הגנה מפני הוצאה לא צפויה.

    1. בטבלת API Keys, בשורה של הפרויקט, בעמודה Billing Tier לוחצים Set up billing
    2. בוחרים מדינה ומאשרים את התנאים, או בוחרים חשבון חיוב קיים של גוגל
    3. ממלאים פרטי קשר ואמצעי תשלום
    4. כשמתבקשים לטעון קרדיט, מתחילים מהמינימום, 5 דולר
    איפה:https://aistudio.google.com/api-keys

    לא חייבים להפעיל טעינה אוטומטית (auto-reload). מי שמפעיל אותה קובע גם Monthly Limit בעמוד Billing, תחת Manage auto-reload.

  3. 3

    קובעים תקרת הוצאה חודשית

    תקרה ברמת הפרויקט עוצרת את השימוש כשמגיעים לסכום שקבעתם. גוגל מגדירה את התכונה כניסיונית ומציינת חריגה אפשרית של כעשר דקות, ולכן קובעים סכום עם מרווח.

    1. פותחים את עמוד Spend ובוחרים את הפרויקט
    2. תחת Monthly spend cap לוחצים Edit spend cap
    3. כותבים סכום חודשי, למשל 20 דולר, ושומרים
    איפה:https://aistudio.google.com/spend
  4. 4

    Claude Code מקים את הכלי ושומר את המפתח

    יוצרים בתיקיית הבית תיקייה חדשה בשם gemini-images, פותחים את אפליקציית Claude במחשב, עוברים ללשונית Code, בוחרים Local, לוחצים Select folder ובוחרים אותה. אחר כך מדביקים את הפרומפט. אם אתם על Windows, מחליפים בו את Mac ב-Windows. לפני כל פעולה Claude Code מראה מה הוא עומד להריץ ומבקש אישור: קוראים ומאשרים אחת אחת, בלי לסמן always allow.

    מדביקים ב-Claude Code
    אני רוצה ליצור תמונות עם Gemini API של גוגל מתוך Claude Code, בדרך הרשמית: ספריית הפייתון google-genai. המחשב שלי הוא Mac.
    
    1. תבדוק אם מותקן אצלי Python בגרסה 3.10 ומעלה, ותתקין אם חסר. לפני כל פעולה תסביר מה אתה מריץ ותחכה לאישור שלי.
    2. תיצור בתיקייה הזאת סביבה וירטואלית בשם .venv ותתקין בה את הספרייה:
    pip install -U google-genai
    3. תיצור קובץ בשם .env עם השורה GEMINI_API_KEY= ותגביל אותו כך שרק המשתמש שלי יוכל לקרוא אותו. תפתח לי אותו בעורך טקסט (ב-Mac עם open -e .env, ב-Windows עם notepad .env) ותחכה שאכתוב לך שהדבקתי את המפתח אחרי הסימן = ושמרתי.
    4. תבדוק שהמפתח נקלט בלי להציג אותו, ותריץ בדיקה חינמית שמציגה את רשימת המודלים (client.models.list) ומסננת את מודלי התמונה.
    5. תכתוב סקריפט בשם image.py שמקבל תיאור, קורא למודל gemini-3.1-flash-image כברירת מחדל לפי הדוגמה העדכנית ב-ai.google.dev/gemini-api/docs/image-generation, ושומר את התמונה בתיקייה output. לפני כל יצירה הסקריפט מציג את המודל ואת המחיר המשוער לפי ai.google.dev/gemini-api/docs/pricing ומחכה לאישור שלי. אל תיצור אף תמונה בשלב הזה.

    את המפתח לא מדביקים בצ'אט. Claude Code פותח קובץ בעורך טקסט, אתם מדביקים בו את המפתח ושומרים, והוא בודק שהמפתח נקלט בלי להציג אותו. לא שמים את התיקייה בתוך תיקייה שמסונכרנת ל-iCloud, ל-OneDrive או ל-Dropbox.

  5. 5

    בודקים שהחיבור עובד

    פותחים שיחה חדשה בלשונית Code, באותה תיקייה, ומדביקים את פרומפט הבדיקה שמופיע מיד כאן למטה. הבדיקה רק מציגה רשימת מודלים ולא מייצרת כלום, ולכן היא חינמית.

    1. בלשונית Code פותחים שיחה חדשה ובוחרים את אותה תיקייה
    2. מעתיקים את פרומפט הבדיקה שמופיע מיד כאן למטה, מדביקים ושולחים
  6. 6

    יוצרים תמונה ראשונה בזול

    המודל הזול ביותר הוא gemini-3.1-flash-lite-image, ולכן את התמונה הראשונה יוצרים בו. Claude Code יציג מחיר משוער ויחכה לאישור שלכם לפני שיורד כסף.

    מדביקים ב-Claude Code
    תריץ את image.py פעם אחת עם המודל gemini-3.1-flash-lite-image, עם התיאור: כוס קפה על שולחן עץ באור בוקר. תציג לי קודם את המחיר המשוער ותחכה לאישור.
בודקים שהחיבור עובד

מדביקים ב-Claude. אם מתקבלת תשובה עם נתונים אמיתיים מהחשבון, הכל מחובר.

פרומפט בדיקה
תבדוק אילו מודלים של תמונה ווידאו זמינים למפתח ה-API שלי כרגע, בלי לייצר שום תמונה או סרטון.

פרומפטים מוכנים לעבודה

יצירה: כמה גרסאות לבאנר
להדביק ב-Claude
תייצר לי 3 גרסאות של באנר לפתיחת החנות בסגנון מינימליסטי, במודל Flash
עריכה: רקע לבן למוצר
להדביק ב-Claude
קח את התמונה הזו של המוצר ותחליף את הרקע לרקע לבן נקי
יצירה: קליפ קצר לסטורי
להדביק ב-Claude
תכין לי קליפ של 5 שניות שמראה כוס קפה מתאדה, ברקע יפה, לסטורי אינסטגרם, במודל Veo המהיר
הערכת עלות מראש
להדביק ב-Claude
כמה יעלה לייצר 50 תמונות מוצר לפי הרשימה הזו, לפני שאתה מריץ משהו
יצירה: תמונת פתיחה איכותית
להדביק ב-Claude
תייצר לי תמונת פתיחה איכותית לעמוד הבית במודל Pro, גם אם הוא יקר יותר
עריכה: הוספת טקסט לתמונה
להדביק ב-Claude
קח את התמונה הזו ותוסיף לה כותרת קצרה בעברית בפינה השמאלית העליונה
דרכים נוספות להתחבר (למתקדמים)
1

הדרך המומלצת: Claude Code בונה סקריפט עם הספרייה הרשמית

API ישיררשמימפרסם: Google (Gemini API), סקריפט שנבנה אצלכם עם Claude Code

בעלי עסקים שרוצים לבקש תמונה או קליפ בשפה רגילה, בלי לכתוב קוד

  1. מוצאים או יוצרים מפתח ב-aistudio.google.com/api-keys, ומוודאים שאין לידו התווית Unrestricted או Blocked
  2. בעמודה Billing Tier לוחצים Set up billing וטוענים קרדיט של 5 דולר לפחות
  3. בעמוד Spend קובעים Monthly spend cap לפרויקט
  4. בלשונית Code באפליקציית Claude מדביקים את הפרומפט מהמדריך, ו-Claude Code מתקין את google-genai, שומר את המפתח בקובץ .env מוגן ובונה סקריפט שמציג מחיר לפני כל יצירה
הספרייה שהסקריפט משתמש בה
pip install -U google-genai
בדיקה חינמית של המודלים הזמינים
curl "https://generativelanguage.googleapis.com/v1beta/models?key=$GEMINI_API_KEY"
חשוב לדעת

השרת הקהילתי nanobanana (@ycse/nanobanana-mcp) לא מומלץ. הגרסה האחרונה שלו, 1.1.1 ממרץ 2026, קוראת רק ל-gemini-3.1-flash-image-preview ול-gemini-3-pro-image-preview, וגוגל סגרה את שניהם ב-25 ביוני 2026.

2

למפתחים: Gemini API ישירות בקוד

API ישיררשמימפרסם: Google

מפתחים שבונים אינטגרציה משלהם, לא דרך שיחה עם Claude

  1. יוצרים מפתח ב-aistudio.google.com/api-keys ומגדירים חיוב וטעינה מראש.
  2. שומרים אותו כ-GEMINI_API_KEY, או GOOGLE_API_KEY שמקבל עדיפות כששניהם מוגדרים יחד.
  3. מתקינים SDK: pip install -U google-genai, או npm install @google/genai.
  4. בוחרים מודל לפי הצורך: gemini-3.1-flash-lite-image, gemini-3.1-flash-image או gemini-3-pro-image לתמונות, ו-veo-3.1-generate-preview לווידאו, שמסומן לסגירה ב-22 באוקטובר 2026.
  5. לפני הרצה גדולה בודקים שוב את דף התמחור ואת דף ה-deprecations, כי המודלים מתחלפים מהר.
התקנת ה-SDK בפייתון
pip install -U google-genai
התקנת ה-SDK בנוד
npm install @google/genai
שמירת המפתח כמשתנה סביבה
export GEMINI_API_KEY="YOUR_API_KEY"
חשוב לדעת

אין שכבה חינמית לתמונה או וידאו ב-API. מאז 28 במאי 2026 מפתחות חדשים ב-AI Studio נוצרים מוגבלים ל-Gemini API, ומפתחות לא מוגבלים נדחים.

איך מחברים בלי לסכן את החשבון

  • את המפתח שומרים רק בקובץ .env מוגן במחשב, לא בקוד פתוח ולא בהודעת צ'אט, כי כל שימוש בו נספר על בעל המפתח
  • קובעים Monthly spend cap בעמוד Spend של AI Studio לפני ההרצה הראשונה, ומשאירים טעינה אוטומטית כבויה או עם Monthly Limit
  • לפני כל הרצה מאשרים את המודל ואת העלות הצפויה ש-Claude Code מציג

כמה זה עולה

לפי דף התמחור הרשמי ai.google.dev/gemini-api/docs/pricing, נכון ל-30.09.2026 אין שכבה חינמית לתמונות או סרטונים. gemini-3.1-flash-lite-image: קלט 0.25 ופלט 30 דולר למיליון טוקנים, כ-0.0336 דולר לתמונת 1K. gemini-3.1-flash-image: קלט 0.50 ופלט 60 דולר למיליון טוקנים, כלומר 0.045 דולר ב-0.5K, 0.067 דולר ב-1K, 0.101 דולר ב-2K ו-0.151 דולר ב-4K. gemini-3-pro-image: קלט 2 ופלט 120 דולר למיליון טוקנים, כלומר 0.134 דולר ב-1K או 2K ו-0.24 דולר ב-4K. gemini-2.5-flash-image עדיין מופיע בדף ב-0.039 דולר לתמונה, אבל גוגל סוגרת אותו ב-2 באוקטובר 2026. Veo 3.1 מתומחר לפי שנייה: הרגילה (veo-3.1-generate-preview) 0.40 דולר ב-720p וב-1080p ו-0.60 דולר ב-4K, המהירה (veo-3.1-fast-generate-preview) 0.10 דולר ב-720p, 0.12 ב-1080p ו-0.30 ב-4K, והקלה (veo-3.1-lite-generate-preview) 0.05 דולר ב-720p ו-0.08 ב-1080p. קליפ של שמונה שניות ברגילה ב-1080p עולה כ-3.20 דולר, בלי טוקני הפרומפט. גרסאות ה-preview של Veo 3.1 מסומנות לסגירה ב-22 באוקטובר 2026. המחירים משתנים, ולכן בודקים את הדף הרשמי לפני הרצה גדולה.

תקלות נפוצות

קיבלתם 402 Payment Required
לפי גוגל, יתרת הקרדיט נגמרה וכל המפתחות בחשבון החיוב נעצרו. נכנסים ל-aistudio.google.com/billing, לוחצים Buy credits וטוענים. לא מנסים שוב לפני כן, כי הבקשה לא תעבור.
ליד המפתח מופיעה התווית Unrestricted או Blocked
גוגל חוסמת מפתחות לא מוגבלים, וגם מפתחות לא מוגבלים שלא היו בשימוש זמן רב. ב-Unrestricted לוחצים Add restrictions ובוחרים Restrict to Gemini API only, וב-Blocked יוצרים מפתח חדש ומעדכנים אותו בקובץ .env.
הכפתור Create API key לא זמין ומופיע You do not have permission to create a key in this project
לחשבון שלכם אין הרשאה בפרויקט הזה. מבקשים ממי שמנהל את הפרויקט תפקיד כמו Project Editor, או יוצרים פרויקט חדש שלא שייך לארגון.
קיבלתם 429 RESOURCE_EXHAUSTED
עברתם את מגבלת הבקשות לדקה או ליום. מחכים כמה דקות ומנסים שוב, ובודקים את המגבלות של הפרויקט ב-aistudio.google.com/rate-limit.
שגיאת model not found עם gemini-3.1-flash-image-preview או gemini-3-pro-image-preview
אלה שמות preview שגוגל סגרה ב-25 ביוני 2026, והשרת הקהילתי nanobanana עדיין משתמש בהם. עוברים לסקריפט הרשמי מהשלב הרביעי, עם gemini-3.1-flash-image או gemini-3-pro-image. גם gemini-2.5-flash-image נסגר ב-2 באוקטובר 2026.

שאלות ותשובות

איפה יוצרים את מפתח ה-API?
בכתובת aistudio.google.com/api-keys. משתמש חדש מקבל פרויקט ומפתח אוטומטית, וליצירת תמונות צריך גם ללחוץ Set up billing ולטעון קרדיט.
יש גרסת חינם לניסיון תמונה או סרטון אחד?
לא. נכון ל-30.09.2026 אין שכבה חינמית למודלי תמונה ווידאו.
כמה עולה בערך תמונה אחת?
תלוי במודל וברזולוציה, בין כ-0.03 לכ-0.24 דולר. הפירוט המלא בסעיף התמחור.
האם Claude בוחר מודל לבד בלי לשאול?
לא. הסקריפט ש-Claude Code בונה מציג את המודל ואת המחיר המשוער ומחכה לאישור לפני כל יצירה.
מה קורה כשמודל שהשתמשתי בו נסגר?
גוגל מודיעה מראש בדף ה-deprecations. gemini-2.5-flash-image נסגר ב-2 באוקטובר 2026, גרסאות ה-preview של Veo 3.1 ב-22 באוקטובר 2026, ואז מבקשים מ-Claude Code להחליף בסקריפט את שם המודל.
למה לא להשתמש בשרת nanobanana?
הגרסה האחרונה שלו, ממרץ 2026, קוראת רק לשמות preview שגוגל סגרה ב-25 ביוני 2026, ולכן היא תחזיר שגיאה. הסקריפט הרשמי עובד עם שמות המודלים העדכניים.

מקורות. את העמוד כתב קורן בן עזרא לפי התיעוד הרשמי של Google ושל Anthropic, נכון ל-30.09.2026. ממשקים משתנים מהר, ולכן אם משהו נראה אחרת, התיעוד הרשמי הוא הקובע. המקורות: 1 · 2 · 3 · 4 · 5 · 6

רוצים שאחבר לכם את זה?

כתבו לי בוואטסאפ מה אתם צריכים, ואני אגיד בכנות אם שווה לחבר ואיך.