Gerenciar o resumo em áudio do notebook (API)

Depois de criar o notebook e adicionar fontes de dados a ele, você pode gerar programaticamente um resumo em áudio do notebook. Um notebook pode ter apenas um resumo em áudio por vez. Esta página descreve como criar e excluir resumos em áudio.

Diferença entre um resumo em áudio e um podcast

Um resumo em áudio é diferente de um podcast das seguintes maneiras:

  • Um resumo em áudio precisa estar associado a um notebook com fontes de dados adicionadas a ele. Por outro lado, um podcast pode ser gerado sem um notebook do Gemini Notebook Enterprise, uma licença do Gemini Enterprise ou um repositório de dados. Para criar um podcast, tudo o que você precisa é de um projeto ativado Google Cloud e da função de usuário da API Podcast.
  • Para criar um resumo em áudio, chame o método notebooks.audioOverview. Para criar um podcast, chame o método podcasts, uma API independente.

Criar um resumo em áudio

Para gerar um resumo em áudio do conteúdo do notebook, chame o notebooks.audioOverviews.create método. Como você só pode ter um resumo em áudio por notebook, esse método só será bem-sucedido se o notebook não tiver um resumo em áudio.

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

Substitua:

  • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:
    • us para a multirregião dos EUA
    • eu para a multirregião da UE
    • global para o local global
    Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
  • PROJECT_NUMBER: o número do Google Cloud projeto.
  • LOCATION: a localização geográfica do seu repositório de dados, como global. Para mais informações, consulte Locais.
  • NOTEBOOK_ID: o identificador exclusivo do notebook.
  • SOURCE_ID: o ID da origem com base na qual você quer gerar o resumo em áudio. O sourceIdsfield é uma matriz opcional. Se você não especificar nenhum ID de origem, todas as origens no notebook serão usadas. Para informações sobre o ID da origem, consulte Adicionar e gerenciar fontes de dados em um notebook (API).
  • EPISODE_FOCUS: uma string que descreve quais tópicos ou conteúdos precisam ser destacados no resumo em áudio.
  • LANGUAGE_CODE: o código do idioma em que o resumo em áudio foi solicitado.

Se a solicitação for bem-sucedida, você receberá uma resposta JSON semelhante à seguinte. Essa resposta mostra que a geração do resumo em áudio está em andamento.

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

Leva alguns minutos para gerar um resumo em áudio.

Verificar um resumo em áudio gerado

Para verificar o resumo em áudio gerado, faça o seguinte:

  1. Abra o notebook. Para mais informações, consulte Acessar o notebook criado.

  2. No Estúdio do notebook, clique em Carregar para carregar a conversa. Leva alguns instantes para carregar a visão geral.

    No estúdio, você pode gerenciar o resumo em áudio com tarefas como mudar a velocidade do vídeo e baixar ou excluir o arquivo de resumo em áudio.

Excluir um resumo em áudio

Para excluir um resumo em áudio, chame o notebooks.audioOverviews.delete método.

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

Substitua:

  • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:
    • us para a multirregião dos EUA
    • eu para a multirregião da UE
    • global para o local global
    Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
  • PROJECT_NUMBER: o número do Google Cloud projeto.
  • LOCATION: a localização geográfica do seu repositório de dados, como global. Para mais informações, consulte Locais.
  • NOTEBOOK_ID: o identificador exclusivo do notebook.

Se a solicitação for bem-sucedida, você receberá um JSON vazio.