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

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

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

音频概览与播客的区别如下：

• 音频概览必须与已添加数据源的笔记本相关联。另一方面，播客可以在没有 Gemini Notebook Enterprise 笔记本、Gemini Enterprise 许可或数据存储区的情况下生成。如需创建播客，您只需要一个已启用 Google Cloud 的项目和“Podcast API User”角色。
• 如需创建音频概览，请调用 notebooks.audioOverview 方法。如需创建播客，请调用 podcasts 方法（一种独立的 API）。

创建音频概览

如需为笔记本中的内容生成音频概览，请调用 notebooks.audioOverviews.create 方法。由于每个笔记本只能有一个音频概览，因此只有当笔记本没有现有音频概览时，此方法才会成功。

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"
  }

如果请求成功，您应该会收到类似于以下内容的 JSON 响应。此响应表明音频概览生成正在进行中。

  {
    "audioOverview": {
      "status": "AUDIO_OVERVIEW_STATUS_IN_PROGRESS",
      "audioOverviewId": "AUDIO_OVERVIEW_ID",
      "generationOptions": {},
      "name": "AUDIO_OVERVIEW_NAME"
    }
  }

生成音频概览需要几分钟时间。

验证生成的音频概览

如需验证生成的音频概览，请执行以下操作：

1. 打开您的笔记本。 如需了解详情，请参阅 访问已创建的笔记本。

2. 在笔记本的 Studio 中，点击 加载 以加载对话。 加载概览需要几秒钟时间。

   在 Studio 中，您可以通过更改播放速度、下载或删除音频概览文件等任务来管理音频概览。

删除音频概览

如需删除现有音频概览，请调用 notebooks.audioOverviews.delete 方法。

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" \

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