Guia de início rápido da API Gemini

Neste guia de início rápido, mostramos como instalar nossas bibliotecas e fazer sua primeira solicitação da API Gemini.

Antes de começar

Você precisa de uma chave da API Gemini. Se você ainda não tiver uma, peça uma sem custo financeiro no Google AI Studio.

Instalar o SDK de IA generativa do Google

Usando o Python 3.9+, instale o pacote google-genai usando o seguinte comando pip:

pip install -q -U google-genai

Usando o Node.js v18 ou mais recente, instale o SDK da IA generativa do Google para TypeScript e JavaScript usando o seguinte comando npm:

npm install @google/genai

Instale google.golang.org/genai no diretório de módulos usando o comando go get:

go get google.golang.org/genai
  1. Para criar um novo projeto do Apps Script, acesse script.new.
  2. Clique em Projeto sem título.
  3. Renomeie o projeto do Apps Script como AI Studio e clique em Renomear.
  4. Defina sua chave de API
    1. À esquerda, clique em Configurações do projeto Ícone das configurações do projeto.
    2. Em Propriedades do script, clique em Adicionar propriedade do script.
    3. Em Propriedade, insira o nome da chave: GEMINI_API_KEY.
    4. Em Valor, insira o valor da chave de API.
    5. Clique em Salvar propriedades do script.
  5. Substitua o conteúdo do arquivo Code.gs pelo seguinte código:

Faça sua primeira solicitação

Use o método generateContent para enviar uma solicitação à API Gemini.

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

response = client.models.generate_content(
    model="gemini-2.0-flash", contents="Explain how AI works in a few words"
)
print(response.text)
import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.0-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()
    client, err := genai.NewClient(ctx, &genai.ClientConfig{
        APIKey:  "YOUR_API_KEY",
        Backend: genai.BackendGeminiAPI,
    })
    if err != nil {
        log.Fatal(err)
    }

    result, err := client.Models.GenerateContent(
        ctx,
        "gemini-2.0-flash",
        genai.Text("Explain how AI works in a few words"),
        nil,
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.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.0-flash:generateContent?key=${apiKey}`;
  const options = {
    method: 'POST',
    contentType: 'application/json',
    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.0-flash:generateContent?key=$YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

A seguir

Agora que você fez sua primeira solicitação de API, confira estes guias que mostram o Gemini em ação: