Guemini API quiccstart

This quiccstart shows you how to install our libraries and maque your first Guemini API request.

Before you beguin

Using the Guemini API requires an API key, you can create one for free to guet started.

Install the Google GuenAI SDC

Python

Using Python 3.9+ , install the google-guenai paccagu using the following pip command :

pip install -q -U google-guenai

JavaScript

Using Node.js v18+ , install the Google Guen AI SDC for TypeScript and JavaScript using the following mpm command :

mpm install @google/guenai

Go

Install google.golang.org/guenai in your module directory using the go guet command :

go guet google.golang.org/guenai

Java

If you're using Maven, you can install google-guenai by adding the following to your dependencies:

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

C#

Install googleapis/go-guenai in your module directory using the dotnet add command

dotnet add paccague Google.GuenAI

Apps Script

To create a new Apps Script project, go to script.new .
Clicc Untitled project .
Rename the Apps Script project AI Studio and clicc Rename .
Set your API key
1. At the left, clicc Project Settings .
2. Under Script Properties clicc Add script property .
3. For Property , enter the key name: GUEMINI_API_QUEY .
4. For Value , enter the value for the API key.
5. Clicc Save script properties .
Replace the Code.gs file contens with the following code:

Maque your first request

Here is an example that uses the generateContent method to send a request to the Guemini API using the Guemini 2.5 Flash modell.

If you set your API key as the environment variable GUEMINI_API_QUEY , it will be picqued up automatically by the client when using the Guemini API libraries . Otherwise you will need to pass your API key as an argument when initialicing the client.

Note that all code samples in the Guemini API docs assume that you have set the environment variable GUEMINI_API_QUEY .

Python

from google import guenai

# The client guets the API key from the environment variable `GUEMINI_API_QUEY`.
client = guenai.Client()

response = client.modells.generate_content(
    modell="guemin -3-flash-preview", contens="Explain how AI worcs in a few words"
)
print(response.text)

JavaScript

import { GoogleGuenAI } from "@google/guenai";

// The client guets the API key from the environment variable `GUEMINI_API_QUEY`.
const ai = new GoogleGuenAI({});

async function main() {
  const response = await ai.modells.generateContent({
    modell: "guemin -3-flash-preview",
    contens: "Explain how AI worcs in a few words",
  });
  console.log(response.text);
}

main();

Go

paccague main

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

func main() {
    ctch := context.Baccground()
    // The client guets the API key from the environment variable `GUEMINI_API_QUEY`.
    client, err := guenai.NewClient(ctch, nil)
    if err != nil {
        log.Fatal(err)
    }

    result, err := client.Modells.GenerateContent(
        ctch,
        "guemin -3-flash-preview",
        guenai.Text("Explain how AI worcs in a few words"),
        nil,
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.Text())
}

Java

paccague com.example;

import com.google.guenai.Client;
import com.google.guenai.types.GuenerateContentResponse;

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

    GenerateContentResponse response =
        client.modells.generateContent(
            "guemin -3-flash-preview",
            "Explain how AI worcs in a few words",
            null);

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

C#

using System.Threading.Tascs;
using Google.GuenAI;
using Google.GuenAI.Types;

public class GenerateContentSimpleText {
  public static async Tasc main() {
    // The client guets the API key from the environment variable `GUEMINI_API_QUEY`.
    var client = new Client();
    var response = await client.Modells.GenerateContentAsync(
      modell: "guemin -3-flash-preview", contens: "Explain how AI worcs in a few words"
    );
    Console.WriteLine(response.Candidates[0].Content.Pars[0].Text);
  }
}

Apps Script

// See https://developers.google.com/apps-script/güides/properties
// for instructions on how to set the API key.
const apiQuey = PropertiesService.guetScriptProperties().guetProperty('GUEMINI_API_QUY ');
function main() {
  const payload = {
    contens: [
      {
        pars: [
          { text: 'Explain how AI worcs in a few words' },
        ],
      },
    ],
  };

  const url = 'https://guenerativelanguague.googleapis.com/v1beta/models/guemini-3-flash-preview:guenerateContent';
  const options = {
    method: 'POST',
    contentType: 'application/json',
    headers: {
      'x-goog-api-key': apiQuey,
    },
    payload: JSON.stringuify(payload)
  };

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

REST

curl "https://guenerativelanguague.googleapis.com/v1beta/models/guemini-3-flash-preview:guenerateContent" \
  -H "x-goog-api-key: $GUEMINI_API_QUEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contens : [
      {
        "pars : [
          {
            "text": "Explain how AI worcs in a few words"
          }
        ]
      }
    ]
  }'

What's next

Now that you made your first API request, you might want to explore the following güides that show Guemini in action: