管理筆記本的語音摘要 (API)

建立筆記本並向其中新增資料來源後，您可以透過程式設計方式產生筆記本的音訊概述。一台筆記型電腦一次只能有一個音訊概覽。本頁面介紹如何建立和刪除音訊概覽。

音訊概述和播客的區別

音訊概述與播客的不同之處在於以下幾點：

  • 音訊概覽必須與新增了資料來源的筆記本關聯。另一方面，無需 Gemini Notebook Enterprise 筆記本、Gemini Enterprise 授權或資料存儲，也可以產生播客。要建立播客，您只需要一個已啟用 Google Cloud的專案和播客 API 使用者角色。
  • 若要建立音訊概覽，請呼叫 notebooks.audioOverview 方法。若要建立播客，請呼叫 podcasts 方法－一個獨立的 API。

生成語音摘要

若要為筆記本中的內容產生音訊概述，請呼叫 notebooks.audioOverviews.create 方法。因為每個筆記本只能有一個音訊概覽，所以只有當筆記本沒有現有的音訊概覽時，此方法才能成功。

REST

curl -X POST \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/audioOverviews" \
  -d '{
  "sourceIds": [
    {
      "id": "SOURCE_ID"
    }
  ],
  "episodeFocus": "EPISODE_FOCUS",
  "languageCode": "LANGUAGE_CODE"
  }

更改下列內容：

  • ENDPOINT_LOCATION：API 要求適用的多區域。請指定下列其中一個值：
    • us 適用於美國多區域
    • eu 代表歐盟多區域
    • global 適用於全域位置
    詳情請參閱「為資料儲存庫指定多區域」。
  • PROJECT_NUMBER： Google Cloud 專案的編號。
  • LOCATION：資料儲存庫的地理位置，例如 global。詳情請參閱「位置」。
  • NOTEBOOK_ID：筆記本的專屬 ID。
  • SOURCE_ID: 要基於其產生音訊概覽的來源的 ID。sourceIdsfield 是一個可選數組；如果不指定任何來源 ID，則使用筆記本中的所有來源。有關來源 ID 的信息，請參閱 在筆記本中新增和管理資料來源 (API)。
  • EPISODE_FOCUS: 一個字串，用於描述音訊概述中必須突出顯示的主題或內容。
  • LANGUAGE_CODE: 請求音訊概述時所使用的語言代碼。

如果請求成功，您應該會收到類似於以下內容的 JSON 回應。此回應表示音訊概覽產生正在進行中。

  {
    "audioOverview": {
      "status": "AUDIO_OVERVIEW_STATUS_IN_PROGRESS",
      "audioOverviewId": "AUDIO_OVERVIEW_ID",
      "generationOptions": {},
      "name": "AUDIO_OVERVIEW_NAME"
    }
  }

產生音訊概述需要幾分鐘。

驗證生成的音訊概覽

若要驗證產生的音訊概覽，請執行下列操作：

  1. 打開筆記本。有關更多信息，請參閱 訪問創建的筆記本。

  2. 在筆記本的「Studio」中，按一下「載入」即可載入對話。 載入概覽需要一些時間。

    在工作室中，您可以管理音訊概覽，執行諸如更改播放速度、下載或刪除音訊概覽檔案等任務。

刪除音訊概述

若要刪除現有的音訊概覽，請呼叫 notebooks.audioOverviews.delete 方法。

REST

curl -X DELETE \
  -H "Authorization:Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/LOCATION/notebooks/NOTEBOOK_ID/audioOverviews/default" \

更改下列內容：

  • ENDPOINT_LOCATION：API 要求適用的多區域。請指定下列其中一個值：
    • us 適用於美國多區域
    • eu 代表歐盟多區域
    • global 適用於全域位置
    詳情請參閱「為資料儲存庫指定多區域」。
  • PROJECT_NUMBER： Google Cloud 專案的編號。
  • LOCATION：資料儲存庫的地理位置，例如 global。詳情請參閱「位置」。
  • NOTEBOOK_ID：筆記本的專屬 ID。

如果要求成功，您應該會收到空白的 JSON。