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

۲۶ بهمن ۱۴۰۴
0 دیدگاه

آموزش دریافت رایگان API Gemini

راهنمای قدم‌به‌قدم اتصال به هوش مصنوعی گوگل (نسخه ۲۰۲۶)

🚀 چرا این آموزش ارزشمند است؟
با این روش شما به مدل قدرتمند Gemini 2.5 Flash متصل می‌شوید و می‌توانید روزانه تا ۱۵۰۰ درخواست رایگان ارسال کنید. این بهترین فرصت برای ساخت ربات‌های هوشمند و تحلیلگر بدون هزینه است.
📋 پیش‌نیازهای حیاتی:
  • نرم‌افزار تغییر IP: سرویس گوگل روی IP ایران بسته است.
  • حساب Gmail: یک ایمیل گوگل ساده کافیست.
  • پایتون (Python): نسخه ۳.۱۰ به بالا پیشنهاد می‌شود.
1
ورود به پنل توسعه‌دهندگان

وارد سایت aistudio.google.com شوید و با جیمیل خود لاگین کنید.

Google AI Studio
2
دریافت کلید API

در منوی سمت چپ، روی گزینه Get API key کلیک کرده و سپس Create API key را بزنید.

Get Key

Create Key

Create Key
3
کپی کردن کلید

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

Copy Key

💻 کد شماره ۱: تست اتصال ساده

«حالا که کلید اختصاصی خود را دریافت کردید، بیایید آن را امتحان کنیم! برای شروع، کافی است کلیدتان را در کد زیر جایگذاری کنید تا یک سلام ساده به مدل پایدار Gemini 2.5 بفرستیم و از اتصال صحیح اینترنت و API مطمئن شویم.»

نصب کتابخانه: در ترمینال بزنید: pip install -q -U google-genai
from 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) طراحی شده است. همین الان با آن صحبت کنید!

❓ سوالات متداول

کدام روش کدنویسی بهتر است؟ (روش ۱ یا ۲)
روش اول (کتابخانه گوگل) ساده‌تر است. روش دوم (REST API) که در «کد پروژه مشاور» استفاده کردیم، حرفه‌ای‌تر است، نیاز به نصب چیزی ندارد و دست شما را برای تنظیمات خاص بازتر می‌گذارد.
خطای "User location not supported" یا 403 می‌گیرم؟
این خطا یعنی گوگل متوجه شده IP شما مربوط به ایران است. فیلترشکن خود را بررسی کنید.
منظور از "مهندسی شخصیت" در کد دوم چیست؟
در مدل‌های جدید جمنای (2.5)، شما می‌توانید قبل از شروع چت، یک نقش به ربات بدهید. در کد دوم، ما به ربات گفتیم که «مشاور لمپا» باشد.

0 دیدگاه