Gemini API: איך משיגים מפתח, מתקשרים לדגם ומה עלות האסימונים
ה- Gemini API הוא הדרך שבה אתה קורא למודלים Gemini מהקוד שלך במקום מחלון צ'אט: בוט תמיכה באתר שלך, סקריפט שעורך כרטיסים, השלמת קוד בעורך, שילוב CRM. המסלול הקלאסי דורש חשבון Google, הגדרת חיוב בענן וכרטיס זר. בNeuralSpace הדרך קצרה יותר: מפתח נוצר בלוח המחוונים שלך תוך כדקה, המודל נקרא עם בקשה תואמת OpenAI, ואתה משלם מיתרה סמלית - ללא מנוי. להלן מדריך שלב אחר שלב: כיצד לקבל מפתח, איך נראית השיחה הראשונה שלך ל-Gemini 3.8 Flash, ומה עלות האסימונים.
מה זה Gemini API ומי צריך אותו
Gemini היא משפחת דגמי השפה של Google. דרך API הוא פתוח למפתחים: אתה שולח מערך של הודעות, מקבל תשובה שנוצרה ומשתמש בה במוצר שלך - הראה אותו למשתמש, אחסן אותו, מעבד אותו הלאה. מקרי שימוש אופייניים: תמיכה בצ'אטבוטים, סיכום מיילים ומסמכים, חילוץ נתונים מובנים מטקסט, ניסוח תוכן, אוטומציה של שגרה בסקריפטים. Gemini 3.8 פלאש בקטלוג NeuralSpace הוא הענף המהיר של המשפחה: איזון של מהירות ומחיר המתאים לדיאלוגים ולעיבוד טקסט בכמות גדולה.
שלב 1. קבל מפתח
- הירשם ב-NeuralSpace עם האימייל שלך - זה לוקח פחות מדקה. משתמשים חדשים זוכים לאסימוני מתחילים מיד, מספיק עבור API השיחות הראשונות ללא טעינה.
- פתח את דף API מפתחות בלוח המחוונים שלך וצור מפתח. המפתח נראה כמו BLK0 ומוצג פעם אחת - שמור אותו מיד במנהל סיסמאות או במשתנה סביבה, לא במאגר שלך.
- בדוק את היתרה שלך: מודלים של טקסט דורשים מינימום של 50 אסימונים בחשבון. העלאות מתרחשות בלוח המחוונים - ללא כרטיסים זרים, ללא דמי מנוי.
שלב 2. התקשר לדגם
Gemini בציבור API עובד דרך נקודת הקצה התואמת OpenAI BLK1: הגוף נושא את המודל, מערך BLK2 עם תפקידי מערכת/משתמש/עוזר, ואת מגבלת BLK3. בקשת תלתל מינימלית:
BLK4
התגובה חוזרת בפורמט OpenAI: הטקסט שנוצר הוא ב-BLK5, השימוש בפועל הוא ב-BLK6. אם כבר יש לך קוד OpenAI SDK, בדיוק שני ערכים משתנים - base_url והמפתח:
BLK7
ממשקי צ'אט נהנים מסטרימינג: הוסף BLK8 והתשובה מגיעה בנתחים דרך Server-Sent Events, כך שהמשתמש יראה את המילים הראשונות לפני השלמת הדור.
שלב 3. דעו מה זה עולה
החיוב נמדד: אסימוני קלט (ההנחיה שלך) ואסימוני פלט (תשובת הדגם) נספרים בנפרד, כל אחד עם מחיר משלו למיליון. עבור Gemini 3.8 Flash, בזמן כתיבת שורות אלה, מדובר ב-33.5 אסימונים למיליון קלט ו-168 אסימונים למיליון פלט. בקשה טיפוסית של "2,000 אסימוני הקשר + 500 אסימוני פלט" עולה בערך 0.15 אסימונים. המחיר צמוד לשער חליפין וצף, אז בדוק את הטבלה החיה לפני שאתה עושה את החישוב: הוא מתפרסם ב- API דף תיעוד והוחזר בצורה קריא מכונה על ידי BLK9. לשם השוואה: DeepSeek V4 Flash באותו קטלוג הוא 21/42 אסימונים למיליון, דגמי קלוד יקרים יותר באופן ניכר; Gemini 3.8 פלאש יושב באמצע במחיר תוך מענה מהיר.
שתי מגבלות שירות: 60 בקשות לדקה לכל מפתח, ויתרה מינימלית של 50 אסימונים עבור דגמי טקסט. היתרה הנוכחית זמינה דרך BLK10 , חיובים מופיעים בהיסטוריית העסקאות בפרופיל שלך.
Gemini באתר - אין צורך בקוד
אם אינך צריך עדיין את API, אותם דגמים חיים בממשק: בחר Gemini 3.8 Flash ב- לְשׂוֹחֵחַ - חיפוש באינטרנט מופעל שם - ולתמונות יצירת תמונה המדור מציע את Nano Banana, דגם המבוסס על Gemini 2.5 Flash. היתרה משותפת: צ'אט ו-API משיכה מאותו חשבון.
שגיאות נפוצות של בקשה ראשונה
- 401 לא מורשה - המפתח הועבר בצורה שגויה: רווח נוסף, ערך קטוע, קידומת שגויה. המפתח המלא עובר אחרי BLK11 או בכותרת BLK12.
- 429 יותר מדי בקשות - הגעת למגבלה של 60 בקשות לדקה. הוסף הפסקה או תור לצדך.
- שגיאת איזון - פחות מ-50 אסימונים בחשבון: הטען בלוח המחוונים ונסה שוב.
- מפתח דלף לתוך git - שמור אותו במשתני סביבה (.env) ולעולם אל תתחייב אותו; אם הוא דולף, הנפק מחדש את המפתח באותו דף API מפתחות.
שאלות נפוצות
האם אני צריך חשבון Google או כרטיס זר?
לא. המפתח מונפק בלוח המחוונים NeuralSpace שלך ואתה משלם מיתרה אסימון: חיוב מבוסס אסימון, ללא מנוי, ללא חיוב בענן.
כמה עולה שיחה של Gemini API?
רק האסימונים בפועל: בזמן הכתיבה, 33.5 אסימונים למיליון קלט ו-168 למיליון פלט עבור Gemini 3.8 פלאש; בקשה של כמה אלפי אסימונים היא בערך 0.15 אסימונים. המחירים העדכניים הם ב-BLK13 ובטבלת התיעוד.
האם יש רמה חינמית?
אין דורות בחינם בפלטפורמה. משתמשים חדשים מקבלים אסימונים למתחילים - מספיק לניסויים ראשונים - לאחר מכן אתה משלם לכל אסימון ללא דמי מנוי.
מה עוד יכול ה-API לעשות מלבד טקסט?
עם אותו מפתח אתה מקבל יצירת תמונה, וידאו ומוזיקה, סינתזה וזיהוי דיבור, ושרת MCP בכתובת https://neuralspace.pro/mcp עבור סוכני AI. רשימת נקודות הקצה המלאה נמצאת בתיעוד.