Gemini API شروع سریع

این راهنمای سریع به شما نشان می‌دهد که چگونه کتابخانه‌های ما را نصب کنید و اولین درخواست API Gemini خود را ارسال کنید.

قبل از اینکه شروع کنی

شما به یک کلید API جمینی نیاز دارید. اگر از قبل آن را ندارید، می‌توانید آن را به صورت رایگان از Google AI Studio دریافت کنید .

نصب SDK گوگل GenAI

پایتون

با استفاده از پایتون ۳.۹+ ، بسته google-genai را با استفاده از دستور pip زیر نصب کنید:

pip install -q -U google-genai

جاوا اسکریپت

با استفاده از Node.js نسخه ۱۸+ ، کیت توسعه نرم‌افزاری Google Gen AI را برای TypeScript و JavaScript با استفاده از دستور npm زیر نصب کنید:

npm install @google/genai

برو

با استفاده از دستور go get، google.golang.org/genai را در دایرکتوری ماژول خود نصب کنید:

go get google.golang.org/genai

جاوا

اگر از Maven استفاده می‌کنید، می‌توانید google-genai را با اضافه کردن موارد زیر به وابستگی‌های خود نصب کنید:

<dependencies>
  <dependency>
    <groupId>com.google.genai</groupId>
    <artifactId>google-genai</artifactId>
    <version>1.0.0</version>
  </dependency>
</dependencies>

سی شارپ

با استفاده از دستور dotnet add، googleapis/go-genai را در دایرکتوری ماژول خود نصب کنید.

dotnet add package Google.GenAI

اسکریپت برنامه‌ها

  1. برای ایجاد یک پروژه جدید Apps Script، به script.new بروید.
  2. روی پروژه بدون عنوان کلیک کنید.
  3. نام پروژه Apps Script را به AI Studio تغییر دهید و روی Rename کلیک کنید.
  4. کلید API خود را تنظیم کنید
    1. در سمت چپ، روی تنظیمات پروژه کلیک کنید آیکون مربوط به تنظیمات پروژه .
    2. در قسمت ویژگی‌های اسکریپت، روی افزودن ویژگی اسکریپت کلیک کنید.
    3. برای Property ، نام کلید را وارد کنید: GEMINI_API_KEY .
    4. برای Value ، مقدار مربوط به کلید API را وارد کنید.
    5. روی ذخیره ویژگی‌های اسکریپت کلیک کنید.
  5. محتویات فایل Code.gs را با کد زیر جایگزین کنید:

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

در اینجا مثالی آورده شده است که از متد generateContent برای ارسال درخواست به API Gemini با استفاده از مدل Gemini 2.5 Flash استفاده می‌کند.

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

توجه داشته باشید که تمام نمونه‌های کد موجود در مستندات API Gemini فرض می‌کنند که شما متغیر محیطی GEMINI_API_KEY تنظیم کرده‌اید.

پایتون

from google import genai

# The client gets the API key from the environment variable `GEMINI_API_KEY`.
client = genai.Client()

response = client.models.generate_content(
    model="gemini-2.5-flash", contents="Explain how AI works in a few words"
)
print(response.text)

جاوا اسکریپت

import { GoogleGenAI } from "@google/genai";

// The client gets the API key from the environment variable `GEMINI_API_KEY`.
const ai = new GoogleGenAI({});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.5-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

برو

package main

import (
    "context"
    "fmt"
    "log"
    "google.golang.org/genai"
)

func main() {
    ctx := context.Background()
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    client, err := genai.NewClient(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }

    result, err := client.Models.GenerateContent(
        ctx,
        "gemini-2.5-flash",
        genai.Text("Explain how AI works in a few words"),
        nil,
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.Text())
}

جاوا

package com.example;

import com.google.genai.Client;
import com.google.genai.types.GenerateContentResponse;

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    Client client = new Client();

    GenerateContentResponse response =
        client.models.generateContent(
            "gemini-2.5-flash",
            "Explain how AI works in a few words",
            null);

    System.out.println(response.text());
  }
}

سی شارپ

using System.Threading.Tasks;
using Google.GenAI;
using Google.GenAI.Types;

public class GenerateContentSimpleText {
  public static async Task main() {
    // The client gets the API key from the environment variable `GEMINI_API_KEY`.
    var client = new Client();
    var response = await client.Models.GenerateContentAsync(
      model: "gemini-2.5-flash", contents: "Explain how AI works in a few words"
    );
    Console.WriteLine(response.Candidates[0].Content.Parts[0].Text);
  }
}

اسکریپت برنامه‌ها

// See https://developers.google.com/apps-script/guides/properties
// for instructions on how to set the API key.
const apiKey = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
function main() {
  const payload = {
    contents: [
      {
        parts: [
          { text: 'Explain how AI works in a few words' },
        ],
      },
    ],
  };

  const url = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent';
  const options = {
    method: 'POST',
    contentType: 'application/json',
    headers: {
      'x-goog-api-key': apiKey,
    },
    payload: JSON.stringify(payload)
  };

  const response = UrlFetchApp.fetch(url, options);
  const data = JSON.parse(response);
  const content = data['candidates'][0]['content']['parts'][0]['text'];
  console.log(content);
}

استراحت

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

قدم بعدی چیست؟

حالا که اولین درخواست API خود را ارسال کردید، شاید بخواهید راهنماهای زیر را که Gemini را در عمل نشان می‌دهند، بررسی کنید: