Audio-Zusammenfassung Ihres Notebooks verwalten (API)

Nachdem Sie Ihr Notebook erstellt und Datenquellen hinzugefügt haben, können Sie programmatisch eine Audio-Zusammenfassung des Notebooks erstellen. Ein bestimmtes Notebook kann jeweils nur eine Audio-Zusammenfassung haben. Auf dieser Seite wird beschrieben, wie Sie Audio-Zusammenfassungen erstellen und löschen.

Unterschied zwischen einer Audio-Zusammenfassung und einem Podcast

Audio-Zusammenfassungen unterscheiden sich in folgenden Punkten von Podcasts:

  • Eine Audio-Zusammenfassung muss mit einem Notebook verknüpft sein, dem Datenquellen hinzugefügt wurden. Ein Podcast kann hingegen ohne NotebookLM Enterprise-Notebook, Gemini Enterprise-Lizenz oder Datenspeicher generiert werden. Zum Erstellen eines Podcasts benötigen Sie lediglich ein aktiviertes Google CloudProjekt und die Rolle „Podcast API User“.
  • Wenn Sie eine Audio-Zusammenfassung erstellen möchten, rufen Sie die Methode notebooks.audioOverview auf. Wenn Sie einen Podcast erstellen möchten, rufen Sie die Methode podcasts auf. Das ist eine eigenständige API.

Audio-Zusammenfassung erstellen

Rufen Sie die Methode notebooks.audioOverviews.create auf, um eine Audio-Zusammenfassung für die Inhalte in Ihrem Notebook zu erstellen. Da Sie nur eine Audio-Zusammenfassung pro Notebook haben können, ist diese Methode nur erfolgreich, wenn für das Notebook noch keine Audio-Zusammenfassung vorhanden ist.

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

Ersetzen Sie Folgendes:

  • ENDPOINT_LOCATION: die Multiregion für Ihre API-Anfrage. Weisen Sie einen der folgenden Werte zu:
    • us für die Multiregion „USA“
    • eu für die Multiregion „EU“
    • global für den Standort „Global“
    Weitere Informationen zum Festlegen multiregionaler Standorte für Ihren Datenspeicher.
  • PROJECT_NUMBER: die Nummer Ihres Google Cloud -Projekts
  • LOCATION: der geografische Standort Ihres Datenspeichers, z. B. global. Weitere Informationen finden Sie unter Gemini Enterprise-Standorte.
  • NOTEBOOK_ID: die eindeutige Kennung des Notebooks
  • SOURCE_ID: Die ID der Quelle, auf deren Grundlage Sie die Audioübersicht erstellen möchten. sourceIdsfield ist ein optionales Array. Wenn Sie keine Quell-IDs angeben, werden alle Quellen im Notebook verwendet. Informationen zur Quell-ID finden Sie unter Datenquellen zu einem Notebook hinzufügen und verwalten (API).
  • EPISODE_FOCUS: Ein String, der beschreibt, welche Themen oder Inhalte in der Audioübersicht hervorgehoben werden müssen.
  • LANGUAGE_CODE: Der Sprachcode, in dem die Audioübersicht angefordert wurde.

Wenn die Anfrage erfolgreich ist, sollte eine JSON-Antwort ähnlich der folgenden zurückgegeben werden. Diese Antwort zeigt, dass die Audio-Zusammenfassung gerade erstellt wird.

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

Die Erstellung einer Audio-Zusammenfassung dauert einige Minuten.

Generierte Audio-Zusammenfassung überprüfen

So überprüfen Sie die generierte Audioübersicht:

  1. Öffnen Sie Ihr Notebook. Weitere Informationen finden Sie unter Auf das erstellte Notebook zugreifen.

  2. Klicken Sie im Studio Ihres Notebooks auf Laden, um die Unterhaltung zu laden. Es dauert einige Augenblicke, bis die Übersicht geladen ist.

    Im Studio können Sie Ihre Audio-Zusammenfassung verwalten, z. B. die Wiedergabegeschwindigkeit ändern und die Audiodatei herunterladen oder löschen.

Audio-Zusammenfassung löschen

Rufen Sie zum Löschen einer vorhandenen Audio-Zusammenfassung die Methode notebooks.audioOverviews.delete auf.

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

Ersetzen Sie Folgendes:

  • ENDPOINT_LOCATION: die Multiregion für Ihre API-Anfrage. Weisen Sie einen der folgenden Werte zu:
    • us für die Multiregion „USA“
    • eu für die Multiregion „EU“
    • global für den Standort „Global“
    Weitere Informationen zum Festlegen multiregionaler Standorte für Ihren Datenspeicher.
  • PROJECT_NUMBER: die Nummer Ihres Google Cloud -Projekts
  • LOCATION: der geografische Standort Ihres Datenspeichers, z. B. global. Weitere Informationen finden Sie unter Gemini Enterprise-Standorte.
  • NOTEBOOK_ID: die eindeutige Kennung des Notebooks

Wenn die Anfrage erfolgreich ist, sollten Sie ein leeres JSON-Objekt erhalten.