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

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

語音摘要和 Podcast 的差異

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

  • 語音摘要必須與已新增資料來源的筆記本建立關聯。另一方面，生成 Podcast 時不需要 Gemini Notebook Enterprise 筆記本、Gemini Enterprise 授權或資料儲存庫。如要建立 Podcast，您只需要啟用 Google Cloud專案和 Podcast API 使用者角色。
  • 如要建立語音摘要，請呼叫 notebooks.audioOverview 方法。如要建立 Podcast，請呼叫 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. 在 Notebook 的「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。