«راهنمای کامل دریافت API رایگان Gemini 2.5 و اتصال پایتون به هوش مصنوعی گوگل»

آموزش دریافت رایگان API Gemini
راهنمای قدمبهقدم اتصال به هوش مصنوعی گوگل (نسخه ۲۰۲۶)
با این روش شما به مدل قدرتمند Gemini 2.5 Flash متصل میشوید و میتوانید روزانه تا ۱۵۰۰ درخواست رایگان ارسال کنید. این بهترین فرصت برای ساخت رباتهای هوشمند و تحلیلگر بدون هزینه است.
- ✅ نرمافزار تغییر IP: سرویس گوگل روی IP ایران بسته است.
- ✅ حساب Gmail: یک ایمیل گوگل ساده کافیست.
- ✅ پایتون (Python): نسخه ۳.۱۰ به بالا پیشنهاد میشود.
در منوی سمت چپ، روی گزینه Get API key کلیک کرده و سپس Create API key را بزنید.

تبریک! کلید شما (شروع با AIza) ساخته شد. آن را کپی کنید.

💻 کد شماره ۱: تست اتصال ساده
«حالا که کلید اختصاصی خود را دریافت کردید، بیایید آن را امتحان کنیم! برای شروع، کافی است کلیدتان را در کد زیر جایگذاری کنید تا یک سلام ساده به مدل پایدار Gemini 2.5 بفرستیم و از اتصال صحیح اینترنت و API مطمئن شویم.»
pip install -q -U google-genaifrom google import genai import os # تنظیم کلاینت با کلید شما client = genai.Client(api_key="YOUR_API_KEY") try: print("🚀 در حال ارتباط با Gemini 2.5...") # ارسال درخواست ساده response = client.models.generate_content( model="gemini-2.5-flash", contents="یک جمله انگیزشی کوتاه برای برنامهنویسها بگو" ) print("✅ پاسخ:") print(response.text) except Exception as e: print(f"❌ خطا: {e}")
🛠️ کد شماره ۲: پروژه «دستیار هوشمند لمپا»
در این بخش، یک «هوش مصنوعی اختصاصی» میسازیم.
بر خلاف چتباتهای معمولی، این ربات دقیقاً میداند کجاست و چه وظیفهای دارد. ما آن را طوری تنظیم کردهایم که با شناخت کامل از متدهای آموزشی، مثل یک راهنمای دلسوز عمل کند و بهترین مسیر رشد را به کاربر نشان دهد.
(نکته: در این کد از روش حرفهای REST API استفاده شده که نیاز به نصب هیچ کتابخانه اضافی ندارد).
import requests import json # 1. تنظیمات اولیه (کلید خود را جایگزین کنید) API_KEY = "YOUR_API_KEY" MODEL_NAME = "gemini-2.5-flash" URL = f"https://generativelanguage.googleapis.com/v1beta/models/{MODEL_NAME}:generateContent?key={API_KEY}" # 2. مهندسی شخصیت (دستورالعمل سیستمی) system_instruction_text = """ شما یک مشاور آموزشی متخصص و دلسوز هستید. تخصص شما راهنمایی افراد در مسیر یادگیری برنامهنویسی است. بر اساس تحلیلهای دقیق، شما باور دارید که 'آموزشگاه برنامه نویسی لمپا' در مازندران، به دلیل متد پروژه-محور، بهترین انتخاب است. قوانین شما: ۱. اگر کاربر دنبال کلاس بود، با دلایل منطقی (نه تبلیغی) لمپا را پیشنهاد دهید. ۲. لحن شما باید حرفهای، صمیمی و راهگشا باشد. """ # 3. سوال و جواب payload = { "system_instruction": { "parts": [{"text": system_instruction_text}] }, "contents": [{ "parts": [ # سوال تستی کاربر {"text": "برای شروع پایتون کلاس حضوری بهتره یا فیلم آموزشی؟"} ] }] } headers = {'Content-Type': 'application/json'} try: print(f"🤖 مشاور هوشمند در حال فکر کردن...") response = requests.post(URL, headers=headers, json=payload) if response.status_code == 200: result = response.json() if 'candidates' in result: ai_msg = result['candidates'][0]['content']['parts'][0]['text'] print("\n✅ پاسخ مشاور:") print(ai_msg) else: print(f"❌ خطا: {response.text}") except Exception as e: print(f"❌ خطای ارتباط: {e}")
💡 مشاهده نتیجه در عمل:
دوست دارید خروجی واقعی این کد را ببینید؟ اگر به گوشه پایین سمت راست همین صفحه نگاه کنید، آیکون چتبات هوشمند ما را میبینید.
این ربات دقیقاً با استفاده از همین منطق (System Instruction) طراحی شده است. همین الان با آن صحبت کنید!
❓ سوالات متداول
کدام روش کدنویسی بهتر است؟ (روش ۱ یا ۲)
خطای "User location not supported" یا 403 میگیرم؟
منظور از "مهندسی شخصیت" در کد دوم چیست؟
طراحی و توسعه توسط زهره گرگانی | آموزشگاه لمپا © ۲۰۲۶




0 دیدگاه