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

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

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

کلید API خود را با دستور curl تأیید کنید

می توانید از دستور curl برای تأیید تنظیمات خود استفاده کنید. می‌توانید کلید API را در URL ارسال کنید:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent?key=${API_KEY}"

یا در هدر x-goog-api-key :

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -H "x-goog-api-key: ${API_KEY}" \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent"

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

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

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

  • هنگامی که روی دریافت کلید API در استودیوی Google AI کلیک می‌کنید، انتخاب می‌کنید که آیا یک کلید API Gemini در پروژه Google Cloud جدید یا موجود ارائه شود. فهرست کلیدهای API در Google AI Studio همه کلیدهای API را نشان می‌دهد که AI Studio برای استفاده با Google AI Gemini API (همراه با تمام پروژه‌های Google Cloud مرتبط با آنها) ارائه کرده است.

    • با این حال، هر کلید API در پروژه Google Cloud به طور بالقوه می تواند برای فراخوانی Google AI Gemini API استفاده شود. می‌توانید تمام کلیدهای API پروژه خود را در APIs & Services > پنل اعتبارنامه‌ها در کنسول Google Cloud مشاهده و مدیریت کنید.

  • افزودن محدودیت‌های کلید API می‌تواند به محدود کردن سطح قابل استفاده از طریق هر کلید API کمک کند. به‌طور پیش‌فرض، کلید Gemini API تولید شده توسط Google AI Studio تنها می‌تواند با Google AI Gemini API (که به طور رسمی «API زبان تولیدی» یا generativelanguage.googleapis.com نامیده می‌شود) استفاده شود.

    • اگر کلیدهای API در پروژه Google Cloud شما فاقد محدودیت‌های API هستند یا کلیدهای API که API زبان مولد را در لیست مجاز قرار داده‌اند، می‌توان از آن کلیدها با Google AI Gemini API استفاده کرد. بهترین کار این است که هر کلید API را فقط به APIهایی که با استفاده از آن کلید فرا می‌خوانید محدود کنید.
    • توجه داشته باشید که حتی با محدودیت‌های کلید API، اگر یک عامل مخرب کلید API شما را بدست آورد، می‌تواند از آن برای برقراری تماس با استفاده از سهمیه پروژه شما برای همه APIهای مجاز برای آن کلید API استفاده کند.

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

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

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

مراحل بعدی

  • شروع سریع API را بررسی کنید تا بهترین روش ها را برای ایمن کردن کلید API خود و استفاده از آن بیاموزید.