Gemini Developer API против Gemini Enterprise Agent Platform

При разработке решений в области генеративного ИИ с помощью Gemini компания Google предлагает два API-продукта: Gemini Developer API и Gemini Enterprise Agent Platform API .

API разработчика Gemini предоставляет самый быстрый способ создания, внедрения и масштабирования приложений на базе Gemini. Большинству разработчиков следует использовать API разработчика Gemini, если только нет необходимости в специальных корпоративных средствах контроля.

Платформа Gemini Enterprise Agent Platform предлагает комплексную экосистему готовых к использованию в корпоративной среде функций и сервисов для создания и развертывания приложений генеративного искусственного интеллекта на базе платформы Google Cloud Platform.

Мы недавно упростили миграцию между этими сервисами. Теперь API для разработчиков Gemini и API для корпоративных агентов Gemini доступны через унифицированный SDK Google GenAI и API для взаимодействия .

Сравнение кода: API взаимодействий (рекомендуется)

API для взаимодействия — это рекомендуемый способ работы с моделями и агентами Gemini. В следующих примерах сравнивается генерация текста между API разработчика Gemini и платформой корпоративных агентов Gemini.

Python

Доступ к сервисам Gemini Developer API и Gemini Enterprise Agent Platform можно получить через библиотеку google-genai ( >= 2.3.0 ). Инструкции по установке google-genai см. на странице библиотек .

API разработчика Gemini 

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 платформы агентов Gemini Enterprise 

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

Доступ к сервисам Gemini Developer API и Gemini Enterprise Agent Platform можно получить через библиотеку @google/genai ( >= 2.3.0 ). Инструкции по установке @google/genai см. на странице библиотек .

API разработчика Gemini 

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 платформы агентов Gemini Enterprise 

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

Сравнение кода: generateContent API

Хотя для новых проектов рекомендуется использовать API Interactions, API generateContent по-прежнему поддерживается.

Python

Доступ к сервисам Gemini Developer API и Gemini Enterprise Agent Platform можно получить через библиотеку google-genai . Инструкции по установке google-genai см. на странице библиотек .

API разработчика Gemini 

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 платформы агентов 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.8-flash", contents="Explain how AI works in a few words"
)
print(response.text)

JavaScript и TypeScript

Доступ к сервисам Gemini Developer API и Gemini Enterprise Agent Platform можно получить через библиотеку @google/genai . Инструкции по установке @google/genai см. на странице библиотек .

API разработчика Gemini 

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 платформы агентов 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.8-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

Идти

Доступ к сервисам Gemini Developer API и Gemini Enterprise Agent Platform можно получить через библиотеку google.golang.org/genai . Инструкции по установке google.golang.org/genai см. на странице библиотек .

API разработчика Gemini 

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 платформы агентов Gemini Enterprise 

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)

}

Другие варианты использования и платформы

Для получения информации о других платформах и сценариях использования обратитесь к руководствам по конкретным сценариям применения в документации по API для разработчиков Gemini и документации по платформе корпоративных агентов Gemini .

Вопросы миграции

При миграции:

Если вам больше не нужен ключ API Gemini для доступа к API разработчика Gemini, следуйте рекомендациям по обеспечению безопасности и удалите его.

Чтобы удалить ключ API:

  1. Откройте страницу « Учетные данные API Google Cloud» .

  2. Найдите ключ API, который хотите удалить, и нажмите значок «Действия» .

  3. Выберите «Удалить ключ API» .

  4. В окне «Удалить учетные данные» выберите «Удалить» .

    Удаление ключа API занимает несколько минут для распространения изменений. После завершения распространения любой трафик, использующий удаленный ключ API, будет отклонен.

Следующие шаги