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

建立筆記本並新增資料來源後，您可以透過程式輔助方式生成筆記本的語音摘要。一個筆記本一次只能有一份語音摘要。本頁說明如何建立及刪除語音摘要。

語音摘要和 Podcast 的差異

語音摘要與 Podcast 的差異如下：

  • 語音摘要必須與已新增資料來源的筆記本建立關聯。另一方面，即使沒有 Gemini Notebook Enterprise 筆記本、Gemini Enterprise 授權或資料儲存庫，也能生成 Podcast。如要建立 Podcast，只要啟用 Google Cloud 專案，並具備 Podcast API 使用者角色即可。
  • 如要建立語音摘要，請呼叫 notebooks.audioOverview 方法。如要建立 Podcast，請呼叫 podcasts 方法，這是一個獨立 API。

使用美國多區域端點

如果您的 Gemini Notebook Enterprise 訂閱方案位於美國多區域，可以將本頁面的要求傳送至美國多區域端點 discoveryengine.us.rep.googleapis.com。多區域端點會處理要求，並在多區域內終止 TLS，因此要求資料在傳輸過程中會保留在美國境內。使用這個端點不會變更筆記本的儲存位置。詳情請參閱 Google Cloud安全性指南中的「區域和多區域 API 端點總覽」。

如要使用美國多區域端點，請對本頁中的每個要求網址進行下列變更：

  1. 將 ENDPOINT_LOCATION-discoveryengine.googleapis.com 主機替換為 discoveryengine.us.rep.googleapis.com。

  2. 將 LOCATION 設為 us。

其餘部分則維持不變。如要瞭解如何選擇訂閱項目的多區域，請參閱「取得訂閱項目」。如需區域和多區域服務端點清單，請參閱虛擬私有雲指南中的「區域和多區域服務端點」一節。

生成語音摘要

如要為筆記本中的內容生成語音摘要，請呼叫 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。