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

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

音频概览与播客的区别

音频概览与播客有以下不同：

  • 音频概览必须与已添加数据源的笔记本相关联。另一方面，您无需 Gemini Notebook Enterprise 笔记本、Gemini Enterprise 许可或数据存储区，即可生成播客。如需创建播客，您只需要一个已启用的 Google Cloud项目和“Podcast API User”角色。
  • 如需创建音频概览，请调用 notebooks.audioOverview 方法。如需创建播客，请调用 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。

每个请求的其余部分保持不变。如需了解如何选择订阅的多区域，请参阅获取订阅。如需查看区域级和多区域级服务端点的列表，请参阅 Virtual Private Cloud 指南中的区域级和多区域级服务端点。

创建音频概览

如需为笔记本中的内容生成音频概览，请调用 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中，点击加载以加载对话。加载概览需要一些时间。

    在 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。