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
- Para criar um novo projeto do Apps Script, acesse script.new.
- Clique em Projeto sem título.
- Renomeie o projeto do Apps Script como AI Studio e clique em Renomear.
- Defina sua chave de API
- À esquerda, clique em Configurações do projeto
.
- Em Propriedades do script, clique em Adicionar propriedade do script.
- Em Propriedade, insira o nome da chave:
GEMINI_API_KEY
. - Em Valor, insira o valor da chave de API.
- Clique em Salvar propriedades do script.
- À esquerda, clique em Configurações do projeto
- 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: