یک کلید Gemini API دریافت کنید

برای استفاده از Gemini API، به یک کلید API نیاز دارید. می توانید با چند کلیک در Google AI Studio یک کلید ایجاد کنید.

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

کلید API خود را تنظیم کنید

برای آزمایش اولیه، می‌توانید یک کلید API را کدنویسی کنید، اما این باید موقتی باشد زیرا ایمن نیست. بقیه این بخش به نحوه تنظیم کلید API به صورت محلی به عنوان یک متغیر محیطی با سیستم عامل های مختلف می پردازد.

Linux/macOS - Bash

Bash یک پیکربندی رایج ترمینال لینوکس و macOS است. با اجرای دستور زیر می توانید بررسی کنید که آیا یک فایل پیکربندی برای آن دارید:

~/.bashrc

اگر پاسخ "هیچ فایل یا دایرکتوری وجود ندارد" است، باید این فایل را ایجاد کرده و با اجرای دستورات زیر باز کنید یا از zsh استفاده کنید:

touch ~/.bashrc
open ~/.bashrc

در مرحله بعد، باید کلید API خود را با افزودن دستور صادرات زیر تنظیم کنید:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

پس از ذخیره فایل، تغییرات را با اجرای:

source ~/.bashrc

macOS - Zsh

Zsh یک پیکربندی رایج ترمینال لینوکس و macOS است. با اجرای دستور زیر می توانید بررسی کنید که آیا یک فایل پیکربندی برای آن دارید:

~/.zshrc

اگر پاسخ "هیچ فایل یا دایرکتوری وجود ندارد" است، باید این فایل را ایجاد کرده و با اجرای دستورات زیر باز کنید یا از bash استفاده کنید:

touch ~/.zshrc
open ~/.zshrc

در مرحله بعد، باید کلید API خود را با افزودن دستور صادرات زیر تنظیم کنید:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

پس از ذخیره فایل، تغییرات را با اجرای:

source ~/.zshrc

ویندوز

  1. در تنظیمات سیستم عبارت "Environment Variables" را جستجو کنید
  2. "متغیرهای کاربر" (برای کاربر فعلی) یا "متغیرهای سیستم" (برای همه کاربران - با احتیاط استفاده کنید) را ویرایش کنید.
  3. متغیر را ایجاد کنید و export GEMINI_API_KEY=your_key_here را اضافه کنید
  4. تغییرات را اعمال کنید

اولین درخواست Gemini API خود را ارسال کنید

می توانید از دستور curl برای تأیید تنظیمات خود استفاده کنید:

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

کلید API خود را ایمن نگه دارید

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

  • Google AI Gemini API از کلیدهای API برای مجوز استفاده می کند. اگر دیگران به کلید Gemini API شما دسترسی پیدا کنند، می‌توانند با استفاده از سهمیه پروژه شما تماس بگیرند، که علاوه بر دسترسی به مدل‌ها و فایل‌های تنظیم‌شده، می‌تواند منجر به از دست رفتن سهمیه یا هزینه‌های اضافی برای پروژه‌های صورت‌حساب شود.

  • افزودن محدودیت‌های کلید API می‌تواند به محدود کردن سطح قابل استفاده از طریق هر کلید API کمک کند.

  • شما مسئول حفظ امنیت کلید Gemini API خود هستید.

    • کلیدهای Gemini API را در کنترل منبع بررسی نکنید.
    • برنامه های سمت کلاینت (اندروید، سوئیفت، وب و دارت/فلاتر) در معرض خطر قرار گرفتن کلیدهای API هستند. توصیه نمی کنیم از SDK های سرویس گیرنده هوش مصنوعی Google در برنامه های تولیدی برای تماس مستقیم با Google AI Gemini API از تلفن همراه و برنامه های وب خود استفاده کنید.

برای برخی از بهترین شیوه های عمومی، می توانید این مقاله پشتیبانی را نیز مرور کنید.