Gemini Developer API 與 Vertex AI

使用 Gemini 開發生成式 AI 解決方案時,Google 提供兩種 API 產品:Gemini Developer APIVertex AI Gemini API

透過 Gemini Developer API,您就能以最快速度建構、正式發布及擴展 Gemini 輔助應用程式。除非需要特定企業控制項,否則大多數開發人員都應使用 Gemini 開發人員 API。

Vertex AI 提供全方位的企業級功能和服務生態系統,可供您建構及部署由 Google Cloud Platform 支援的生成式 AI 應用程式。

我們最近簡化了這兩項服務之間的遷移作業。現在可透過整合式 Google Gen AI SDK 存取 Gemini 開發人員 API 和 Vertex AI Gemini API。

程式碼比較

本頁面會並列比較 Gemini Developer API 和 Vertex AI 文字生成快速入門指南的程式碼。

Python

您可以使用 google-genai 程式庫存取 Gemini 開發人員 API 和 Vertex AI 服務。如需如何安裝 google-genai 的操作說明,請參閱程式庫頁面。

Gemini Developer API

from google import genai

client = genai.Client()

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

Vertex AI Gemini API

from google import genai

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

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

JavaScript 和 TypeScript

您可以透過@google/genai程式庫存取 Gemini 開發人員 API 和 Vertex AI 服務。如需安裝 @google/genai 的操作說明,請參閱程式庫頁面。

Gemini Developer API

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

const ai = new GoogleGenAI({});

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

main();

Vertex AI Gemini 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-2.0-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

Go

您可以透過google.golang.org/genai程式庫存取 Gemini 開發人員 API 和 Vertex AI 服務。如需安裝 google.golang.org/genai 的操作說明,請參閱程式庫頁面。

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

}

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

}

其他用途和平台

如要瞭解其他平台和用途,請參閱 Gemini 開發人員 API 說明文件Vertex AI 說明文件中的特定用途指南。

遷移注意事項

遷移時:

如果不再需要使用 Gemini API 金鑰存取 Gemini Developer API,請遵循安全性最佳做法刪除金鑰。

刪除 API 金鑰的做法如下:

  1. 開啟 Google Cloud API 憑證頁面。

  2. 找出要刪除的 API 金鑰,然後點選「動作」圖示。

  3. 選取「刪除 API 金鑰」

  4. 在「刪除憑證」模式中,選取「刪除」

    刪除 API 金鑰需要幾分鐘的時間才會生效。作業完畢後,凡是使用已刪除 API 金鑰的流量都會遭拒。

後續步驟