Gemini API شروع سریع

این شروع سریع به شما نشان می دهد که چگونه با استفاده از SDK انتخابی خود با Gemini API شروع کنید.


مشاهده در گوگل AI یک نوت بوک کولب را امتحان کنید مشاهده نوت بوک در GitHub

پیش نیازها

این شروع سریع فرض می کند که شما با ساخت برنامه های کاربردی با پایتون آشنا هستید.

برای تکمیل این شروع سریع، مطمئن شوید که محیط توسعه شما شرایط زیر را برآورده می کند:

  • پایتون 3.9+

Google AI SDK را نصب کنید

Python SDK برای Gemini API در بسته google-generativeai موجود است. وابستگی را با استفاده از pip نصب کنید:

pip install -q -U google-generativeai

احراز هویت را تنظیم کنید

ساده ترین راه برای احراز هویت در Gemini API پیکربندی یک کلید API است، همانطور که در این بخش توضیح داده شده است. اگر به کنترل‌های دسترسی سخت‌تر نیاز دارید، می‌توانید به جای آن از OAuth استفاده کنید .

اگر از قبل یک کلید API ندارید، در Google AI Studio ایجاد کنید.

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

سپس، کلید خود را پیکربندی کنید.

اکیداً توصیه می شود که یک کلید API را در سیستم کنترل نسخه خود بررسی نکنید ، بلکه آن را به عنوان یک متغیر محیطی اختصاص دهید:

export API_KEY=<YOUR_API_KEY>

وارد کردن کتابخانه

کتابخانه هوش مصنوعی Google Generative را وارد و پیکربندی کنید. 

import google.generativeai as genai
import os

genai.configure(api_key=os.environ["API_KEY"])

اولین درخواست خود را مطرح کنید

برای تولید متن از متد generateContent استفاده کنید. 

model = genai.GenerativeModel("gemini-1.5-flash")
response = model.generate_content("Write a story about a magic backpack.")
print(response.text)
text_generation.py

بعدش چی

اکنون که برای درخواست به Gemini API تنظیم شده‌اید، می‌توانید از طیف کاملی از قابلیت‌های Gemini API برای ایجاد برنامه‌ها و گردش‌های کاری خود استفاده کنید. برای شروع کار با قابلیت‌های Gemini API، به راهنمای زیر مراجعه کنید:

برای مستندات عمیق روش‌های API Gemini و پارامترهای درخواست، به راهنماهای موجود در مرجع API مراجعه کنید.