Gemini Developer API vs. Gemini Enterprise Agent Platform

Gemini Developer API vs. Gemini Enterprise Agent Platform

Gemini으로 생성형 AI 솔루션을 개발할 때 Google은 두 가지 API 제품을 제공해요. 바로 Gemini Developer API와 Gemini Enterprise Agent Platform API죠.

Gemini Developer API는 Gemini 기반 애플리케이션을 빌드·프로덕션화·확장하는 가장 빠른 경로예요. 특정 엔터프라이즈 제어가 필요하지 않다면 대부분의 개발자가 Gemini Developer API를 쓰면 돼요.

Gemini Enterprise Agent Platform은 Google Cloud Platform을 기반으로 생성형 AI 애플리케이션을 구축·배포하기 위한 엔터프라이즈급 기능과 서비스의 포괄적인 생태계를 제공해요.

최근에 이 서비스들 사이의 마이그레이션이 간소화됐어요. 이제 Gemini Developer API와 Gemini Enterprise Agent Platform API 모두 통합된 Google Gen AI SDK로 접근할 수 있어요.

출처: 원문

본문

코드 비교 (Code comparison)

이 페이지는 텍스트 생성을 위한 Gemini Developer API와 Gemini Enterprise Agent Platform quickstart의 코드를 나란히 비교해 둔 거예요.

Python

google-genai 라이브러리를 통해 Gemini Developer API와 Gemini Enterprise Agent Platform 서비스 모두에 접근할 수 있어요. google-genai 설치 방법은 libraries 페이지를 참고하세요.

Gemini Developer API:

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)

Gemini Enterprise Agent Platform API:

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

@google/genai 라이브러리를 통해 두 서비스 모두에 접근할 수 있어요. 설치 방법은 libraries 페이지를 참고하세요.

Gemini Developer API:

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

Gemini Enterprise Agent Platform API:

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

google.golang.org/genai 라이브러리를 통해 두 서비스 모두에 접근할 수 있어요. 설치 방법은 libraries 페이지를 참고하세요.

Gemini Developer API:

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)

}

Gemini Enterprise Agent Platform API:

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

}

기타 사용 사례와 플랫폼 (Other use cases and platforms)

다른 플랫폼과 사용 사례에 대해서는 Gemini Developer API 문서와 Gemini Enterprise Agent Platform 문서의 사용 사례별 가이드를 참고하세요.

마이그레이션 고려 사항 (Migration considerations)

마이그레이션할 때 다음을 기억하세요:

더 이상 Gemini Developer API용 API 키를 사용하지 않는다면, 보안 모범 사례에 따라 삭제하세요.

API 키를 삭제하려면:

  1. Google Cloud API Credentials 페이지를 엽니다.
  2. 삭제할 API 키를 찾아 Actions 아이콘을 클릭합니다.
  3. Delete API key를 선택합니다.
  4. Delete credential 모달에서 Delete를 선택합니다. API 키 삭제는 전파되는 데 몇 분이 걸려요. 전파가 완료되면 삭제된 API 키를 사용하는 모든 트래픽이 거부돼요.

중요: 프로덕션에서 아직 사용 중인 키를 삭제했고 복구해야 한다면, gcloud beta services api-keys undelete 명령을 참고하세요.

다음 단계 (Next steps)

더 알아보기 (Learn more)