API Gemini Developer x plataforma Gemini

Ao desenvolver soluções de IA generativa com o Gemini, o Google oferece dois produtos de API: a API Gemini Developer e a API da plataforma Gemini.

A API Gemini Developer oferece o caminho mais rápido para criar, produzir e dimensionar aplicativos com tecnologia do Gemini. A maioria dos desenvolvedores deve usar a API Gemini Developer, a menos que haja necessidade de controles empresariais específicos.

A plataforma Gemini oferece um ecossistema abrangente de recursos e serviços prontos para empresas para criar e implantar aplicativos de IA generativa com tecnologia do Google Cloud.

Recentemente, simplificamos a migração entre esses serviços. Agora, a API Gemini Developer e a API da plataforma Gemini podem ser acessadas pelo SDK Google GenAI unificado e pela API Interactions.

Comparação de código: API Interactions (recomendada)

A API Interactions é a maneira recomendada de criar com modelos e agentes do Gemini. Os exemplos a seguir comparam a geração de texto entre a API Gemini Developer e a plataforma Gemini.

Python

Você pode acessar a API Gemini Developer e os serviços da plataforma Gemini pela biblioteca google-genai (>= 2.3.0). Consulte a página bibliotecas para instruções sobre como instalar google-genai.

API Gemini Developer

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)

API da plataforma Gemini

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 e TypeScript

Você pode acessar a API Gemini Developer e os serviços da plataforma Gemini pela biblioteca @google/genai (>= 2.3.0). Consulte a página bibliotecas para instruções sobre como instalar @google/genai.

API Gemini Developer

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);

API da plataforma Gemini

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);

Comparação de código: API generateContent

Embora a API Interactions seja recomendada para novos projetos, a API generateContent ainda tem suporte.

Python

Você pode acessar a API Gemini Developer e os serviços da plataforma Gemini usando a biblioteca google-genai. Consulte a página de bibliotecas para instruções sobre como instalar google-genai.

API Gemini Developer

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)

API da plataforma Gemini

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 e TypeScript

Você pode acessar a API Gemini Developer e os serviços da plataforma Gemini usando a biblioteca @google/genai. Consulte a página de bibliotecas para instruções sobre como instalar @google/genai.

API Gemini Developer

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();

API da plataforma Gemini

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

Você pode acessar a API Gemini Developer e os serviços da plataforma Gemini usando a biblioteca google.golang.org/genai. Consulte a página de bibliotecas para instruções sobre como instalar google.golang.org/genai.

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

}

API da plataforma Gemini

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)

}

Outros casos de uso e plataformas

Consulte os guias específicos de casos de uso na documentação da API Gemini Developer e na documentação da plataforma Gemini para outras plataformas e casos de uso.

Considerações sobre a migração

Ao migrar:

Se você não precisar mais usar sua chave da API Gemini para a API Gemini Developer, siga as práticas recomendadas de segurança e exclua a chave.

Para excluir uma chave de API:

  1. Abra a página Credenciais da API Google Cloud.

  2. Encontre a chave de API que você quer excluir e clique no ícone Ações.

  3. Selecione Excluir chave de API.

  4. No modal Excluir credencial, selecione Excluir.

    A remoção de uma chave de API leva alguns minutos para ser propagada. Após o término da propagação, todo tráfego que usar a chave de API excluída será recusado.

Próximas etapas