Gemini Developer API 與 Vertex AI

使用 Gemini 開發生成式 AI 解決方案時，Google 提供兩種 API 產品：Gemini Developer API 和 Vertex AI Gemini API。

Gemini Developer API 提供最快速的建構、正式發布和擴充 Gemini 技術輔助應用程式的方式。除非需要特定的企業控制項，否則大多數開發人員都應使用 Gemini Developer API。

Vertex AI 提供完整的企業級功能和服務生態系統，可在 Google Cloud Platform 的支援下建構及部署生成式 AI 應用程式。

我們最近簡化了這些服務之間的遷移作業。如今，您可以透過整合式 Google Gen AI SDK 存取 Gemini Developer API 和 Vertex AI Gemini API。

程式碼比較

本頁面會並排比較 Gemini Developer API 和 Vertex AI 快速入門指南的程式碼，以便產生文字。

Python

您可以透過 google-genai 程式庫存取 Gemini Developer API 和 Vertex AI 服務。請參閱「程式庫」頁面，瞭解如何安裝 google-genai。

Gemini Developer API

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

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 Developer API 和 Vertex AI 服務。請參閱「程式庫」頁面，瞭解如何安裝 @google/genai。

Gemini Developer API

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

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });

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 Developer 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, &genai.ClientConfig{
    APIKey:  apiKey,
    Backend: genai.BackendGeminiAPI,
  })

  // 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 Developer API 的 Gemini API 金鑰，請按照安全性最佳做法刪除金鑰。

刪除 API 金鑰的做法如下：

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

  2. 找出要刪除的 API 金鑰，然後按一下「動作」圖示。

  3. 選取「Delete API key」(刪除 API 金鑰)。

  4. 在「刪除憑證」對話方塊中，選取「刪除」。

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

後續步驟