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

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

音訊總覽和 Podcast 的差異

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

  • 語音摘要必須與已新增資料來源的筆記本建立關聯。另一方面，生成 Podcast 時不需要 NotebookLM 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. 在筆記本的「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。