Gerenciar o resumo em áudio do notebook (API)

Depois de criar o notebook e adicionar fontes de dados a ele, é possível gerar um Resumo em Áudio do notebook de forma programática. Um notebook pode ter apenas um Resumo em Áudio por vez. Nesta página, descrevemos como criar e excluir resumos em áudio.

Diferença entre um Resumo em Áudio e um podcast

O 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, você só precisa de um projeto do Google Cloud ativado e do papel 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.

Usar o endpoint multirregional dos EUA

Se a assinatura do Gemini Notebook Enterprise estiver na multirregião dos EUA, você poderá enviar as solicitações desta página para o endpoint multirregional dos EUA, discoveryengine.us.rep.googleapis.com. Um endpoint multirregional processa suas solicitações e encerra o TLS na multirregião, para que os dados da solicitação permaneçam nos EUA enquanto estão em trânsito. O uso desse endpoint não muda o local de armazenamento dos notebooks. Para mais informações, consulte Visão geral dos endpoints de API regionais e multirregionais no guia de segurança do Google Cloud.

Para usar o endpoint multirregional dos EUA, faça as seguintes alterações em cada URL de solicitação nesta página:

  1. Substitua o host ENDPOINT_LOCATION-discoveryengine.googleapis.com por discoveryengine.us.rep.googleapis.com.

  2. Defina LOCATION como us.

O restante de cada solicitação permanece o mesmo. Para saber como escolher a multirregião da sua assinatura, consulte Criar uma assinatura. Para ver a lista de endpoints de serviço regionais e multirregionais, consulte Endpoints de serviço regionais e multirregionais no guia da nuvem privada virtual.

Crie um resumo em áudio

Para gerar um Resumo em Áudio do conteúdo no seu notebook, chame o método notebooks.audioOverviews.create. Como só é possível ter um Resumo em Áudio por notebook, esse método só funciona 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 projeto do Google Cloud .
  • LOCATION: a localização geográfica do repositório de dados, como global. Saiba mais em Locais.
  • NOTEBOOK_ID: o identificador exclusivo do notebook.
  • SOURCE_ID: o ID da fonte com base na qual você quer gerar o Resumo em Áudio. O sourceIdsfield é uma matriz opcional. Se você não especificar nenhum ID de fonte, todas as fontes no notebook serão usadas. Para informações sobre o ID da fonte, consulte Adicionar e gerenciar fontes de dados em um notebook (API).
  • EPISODE_FOCUS: uma string que descreve quais temas ou conteúdo 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ê vai receber uma resposta JSON semelhante a esta: 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"
    }
  }

A geração de um Resumo em Áudio leva alguns minutos.

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 Studio do notebook, clique em Carregar para carregar a conversa. A visão geral leva alguns instantes para carregar.

    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 do Resumo em Áudio.

Excluir um Resumo em Áudio

Para excluir um Resumo em Áudio, chame o método 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" \

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 projeto do Google Cloud .
  • LOCATION: a localização geográfica do repositório de dados, como global. Saiba mais em Locais.
  • NOTEBOOK_ID: o identificador exclusivo do notebook.

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