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 con la API de Interactions.

Antes de comenzar

Para usar la API de Gemini, necesitas una clave de API. Puedes crear una de forma gratuita para comenzar.

Crea una clave de la API de Gemini

Instala el SDK de IA generativa de Google

Python

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

pip install -q -U google-genai

JavaScript

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

Realiza tu primera solicitud

A continuación, se muestra un ejemplo que usa la API de Interactions para enviar una solicitud a la API de Gemini con el modelo Gemini 3 Flash.

Si configuras tu clave de API como la variable de entorno GEMINI_API_KEY, el cliente la detectará automáticamente cuando uses las bibliotecas de la API de Gemini. De lo contrario, deberás pasar tu clave de API como un argumento cuando inicialices el cliente.

Ten en cuenta que todas las muestras de código en la documentación de la API de Gemini suponen que estableciste la variable de entorno GEMINI_API_KEY.

Python

from google import genai

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

interaction = client.interactions.create(
    model="gemini-3-flash-preview", 
    input="Explain how AI works in a few words"
)

# Print the model's text response
for step in interaction.steps:
    if step.type == "model_output":
        for content_block in step.content:
            if content_block.type == "text":
                print(content_block.text)

JavaScript

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 interaction = await ai.interactions.create({
    model: "gemini-3-flash-preview",
    input: "Explain how AI works in a few words",
  });

  const modelStep = interaction.steps.find(s => s.type === 'model_output');
  if (modelStep) {
    for (const contentBlock of modelStep.content) {
      if (contentBlock.type === 'text') console.log(contentBlock.text);
    }
  }
}

main();

REST

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3-flash-preview",
    "input": "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 que muestran Gemini en acción: