Comparación entre la API de Gemini Developer y Agent Platform de Gemini Enterprise

Cuando desarrollas soluciones de IA generativa con Gemini, Google ofrece dos productos de API: la API de Gemini Developer y la API de Gemini Enterprise Agent Platform.

La API para desarrolladores de Gemini proporciona la ruta más rápida para compilar, llevar a producción y escalar aplicaciones potenciadas por Gemini. La mayoría de los desarrolladores deberían usar la API de Gemini Developer, a menos que necesiten controles empresariales específicos.

Gemini Enterprise Agent Platform ofrece un ecosistema integral de funciones y servicios listos para empresas para crear e implementar aplicaciones de IA generativa respaldadas por Google Cloud Platform.

Recientemente, simplificamos la migración entre estos servicios. Ahora se puede acceder a la API de Gemini Developer y a la API de Gemini Enterprise Agent Platform a través del SDK de GenAI de Google unificado y la API de Interactions.

Comparación de código: API de Interactions (recomendada)

La API de Interactions es la forma recomendada de crear soluciones con modelos y agentes de Gemini. En los siguientes ejemplos, se compara la generación de texto entre la API de Gemini Developer y Gemini Enterprise Agent Platform.

Python

Puedes acceder a los servicios de la API de Gemini Developer y de Gemini Enterprise Agent Platform a través de la biblioteca google-genai (>= 2.3.0). Consulta la página de bibliotecas para obtener instrucciones sobre cómo instalar google-genai.

from google import genai

client = genai.Client()

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

from google import genai

client = genai.Client(
    enterprise=True, project="your-project-id", location="global"
)

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

JavaScript y TypeScript

Puedes acceder a los servicios de la API de Gemini Developer y de Gemini Enterprise Agent Platform a través de la biblioteca @google/genai (>= 2.3.0). Consulta la página de bibliotecas para obtener instrucciones sobre cómo instalar @google/genai.

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

const interaction = await ai.interactions.create({
  model: "gemini-3.8-flash",
  input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  enterprise: true,
  project: "your_project",
  location: "global",
});

const interaction = await ai.interactions.create({
  model: "gemini-3.8-flash",
  input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);

Comparación de código: API de generateContent

Si bien se recomienda la API de Interactions para proyectos nuevos, la API de generateContent sigue siendo compatible.

Python

Puedes acceder a los servicios de la API de Gemini Developer y de Gemini Enterprise Agent Platform a través de la biblioteca de google-genai. Consulta la página de bibliotecas para obtener instrucciones sobre cómo instalar google-genai.

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-3.8-flash", contents="Explain how AI works in a few words"
)
print(response.text)

from google import genai

client = genai.Client(
    vertexai=True, project='your-project-id', location='us-central1'
)

response = client.models.generate_content(
    model="gemini-3.8-flash", contents="Explain how AI works in a few words"
)
print(response.text)

JavaScript y TypeScript

Puedes acceder a los servicios de la API de Gemini Developer y de Gemini Enterprise Agent Platform a través de la biblioteca de @google/genai. Consulta la página de bibliotecas para obtener instrucciones sobre cómo instalar @google/genai.

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-3.8-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

import { GoogleGenAI } from '@google/genai';
const ai = new GoogleGenAI({
  vertexai: true,
  project: 'your_project',
  location: 'your_location',
});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-3.8-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

Go

Puedes acceder a los servicios de la API de Gemini Developer y de Gemini Enterprise Agent Platform a través de la biblioteca de google.golang.org/genai. Consulta la página de bibliotecas para obtener instrucciones sobre cómo instalar google.golang.org/genai.

import (
  "context"
  "encoding/json"
  "fmt"
  "log"
  "google.golang.org/genai"
)

// Your Google API key
const apiKey = "your-api-key"

func main() {
  ctx := context.Background()
  client, err := genai.NewClient(ctx, nil)
  if err != nil {
      log.Fatal(err)
  }

  // Call the GenerateContent method.
  result, err := client.Models.GenerateContent(ctx, "gemini-3.8-flash", genai.Text("Tell me about New York?"), nil)

}

import (
  "context"
  "encoding/json"
  "fmt"
  "log"
  "google.golang.org/genai"
)

// Your Google Cloud project
const project = "your-project"

// A Google Cloud location like "us-central1"
const location = "some-gcp-location"

func main() {
  ctx := context.Background()
  client, err := genai.NewClient(ctx, &genai.ClientConfig
  {
        Project:  project,
      Location: location,
      Backend:  genai.BackendVertexAI,
  })

  // Call the GenerateContent method.
  result, err := client.Models.GenerateContent(ctx, "gemini-3.8-flash", genai.Text("Tell me about New York?"), nil)

}

Otros casos de uso y plataformas

Consulta las guías específicas de casos de uso en la documentación de la API de Gemini Developer y la documentación de Gemini Enterprise Agent Platform para otras plataformas y casos de uso.

Consideraciones sobre la migración

Cuando migres, ocurrirá lo siguiente:

• Deberás usar cuentas de servicio de Google Cloud para autenticarte. Consulta la documentación de Gemini Enterprise Agent Platform para obtener más información.

• Puedes usar tu proyecto existente de Google Cloud (el mismo que usaste para generar tu clave de API) o puedes crear un proyecto nuevo de Google Cloud.

• Las regiones admitidas pueden diferir entre la API de Gemini Developer y la API de Gemini Enterprise Agent Platform. Durante la versión preliminar, la API de Interactions en Gemini Enterprise Agent Platform solo admite el endpoint global (location="global"). Consulta la lista de regiones compatibles con la IA generativa en Google Cloud.

• Todos los modelos que creaste en Google AI Studio deben volver a entrenarse en Gemini Enterprise Agent Platform.

Si ya no necesitas usar tu clave de la API de Gemini para la API para desarrolladores de Gemini, sigue las prácticas recomendadas de seguridad y bórrala.

Para borrar una clave de API, haz lo siguiente:

1. Abre la página Credenciales de la API de Google Cloud.

2. Busca la clave de API que deseas borrar y haz clic en el ícono Acciones.

3. Selecciona Borrar clave de API.

4. En la ventana modal Borrar credencial, selecciona Borrar.

   Borrar una clave de API por completo demora algunos minutos. Una vez que finalice este proceso, el tráfico que use la clave de API borrada se rechazará.

Próximos pasos

• Explora la guía para desarrolladores de la API de Interactions en Gemini Enterprise Agent Platform.
• Consulta la descripción general de la IA generativa en Gemini Enterprise Agent Platform para obtener más información sobre las soluciones de IA generativa en Gemini Enterprise Agent Platform.