管理笔记本的音频概览 (API)

创建笔记本并向其中添加数据源后，您可以以编程方式生成笔记本的音频概览。一个笔记本一次只能有一个音频概览。本页介绍了如何创建和删除音频概览。

音频概览与播客之间的区别

音频概览与播客的不同之处体现在以下几个方面：

  • 音频概览必须与已添加数据源的笔记本相关联。另一方面，无需 NotebookLM Enterprise 笔记本、Gemini Enterprise 许可或数据存储区即可生成播客。如需创建播客，您只需拥有已启用的 Google Cloud项目和“Podcast 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：笔记本的唯一标识符。
  • 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：笔记本的唯一标识符。

如果请求成功，您应该会收到一个空 JSON。