Guía de inicio rápido de la API de Gemini

En esta guía de inicio rápido, se muestra cómo instalar nuestras bibliotecas y realizar tu primera solicitud a la API de Gemini.

Antes de comenzar

Necesitas una clave de API de Gemini. Si aún no tienes una, puedes obtenerla de forma gratuita en Google AI Studio.

Instala el SDK de Google GenAI

PythonJavaScriptGoApps Script

Con Python 3.9 o versiones posteriores, instala el paquete google-genai con el siguiente comando pip:

pip install -q -U google-genai

Con Node.js v18 o versiones posteriores, instala el SDK de IA generativa de Google para TypeScript y JavaScript con el siguiente comando npm:

npm install @google/genai

Instala google.golang.org/genai en tu directorio de módulos con el comando go get:

go get google.golang.org/genai
  1. Para crear un nuevo proyecto de Apps Script, ve a script.new.
  2. Haz clic en Proyecto sin título.
  3. Cambia el nombre del proyecto de Apps Script a AI Studio y haz clic en Cambiar nombre.
  4. Configura tu clave de API.
    1. A la izquierda, haz clic en Configuración del proyecto El ícono de configuración del proyecto.
    2. En Script Properties, haz clic en Add script property.
    3. En Propiedad, ingresa el nombre de la clave: GEMINI_API_KEY.
    4. En Valor, ingresa el valor de la clave de API.
    5. Haz clic en Guardar las propiedades de la secuencia de comandos.
  5. Reemplaza el contenido del archivo Code.gs por el siguiente código:

Realiza tu primera solicitud

Usa el método generateContent para enviar una solicitud a la API de Gemini.

PythonJavaScriptGoApps ScriptREST 
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"
          }
        ]
      }
    ]
  }'

¿Qué sigue?

Ahora que realizaste tu primera solicitud a la API, te recomendamos que explores las siguientes guías en las que se muestra Gemini en acción: