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 para desarrolladores de Gemini y la API de la plataforma de agentes de Gemini Enterprise.

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.

La plataforma de agentes de Gemini Enterprise ofrece un ecosistema integral de funciones y servicios listos para la empresa para crear e implementar aplicaciones de IA generativa respaldadas por Google Cloud.

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 IA generativa de Google unificado.

Comparación de código

En esta página, se comparan los códigos de inicio rápido de la API para desarrolladores de Gemini y de la Agent Platform de Gemini Enterprise para la generación de texto.

Python

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

API de Gemini Developer

from google import genai

client = genai.Client()

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

API de Agent Platform de Gemini Enterprise

from google import genai

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

response = client.models.generate_content(
    model="gemini-3-flash-preview", 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 la Agent Platform de Gemini Enterprise a través de la biblioteca @google/genai. Consulta la página de bibliotecas para obtener instrucciones sobre cómo instalar @google/genai.

API de Gemini Developer

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

const ai = new GoogleGenAI({});

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

main();

API de Agent Platform de Gemini Enterprise

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-flash-preview",
    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 la Agent Platform de Gemini Enterprise a través de la biblioteca google.golang.org/genai. Consulta la página de bibliotecas para obtener instrucciones sobre cómo instalar google.golang.org/genai.

API de Gemini Developer

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-flash-preview", genai.Text("Tell me about New York?"), nil)

}

API de Agent Platform de Gemini Enterprise

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

// Your GCP project
const project = "your-project"

// A GCP 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-flash-preview", genai.Text("Tell me about New York?"), nil)

}

Otros casos de uso y plataformas

Consulta las guías específicas para cada caso 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, ten en cuenta lo siguiente:

Si ya no necesitas usar tu clave de la API de Gemini para la API de Gemini para desarrolladores, 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