노트북의 AI 오디오 오버뷰 관리 (API)

노트북을 만들고 데이터 소스를 추가한 후 프로그래매틱 방식으로 노트북의 오디오 개요를 생성할 수 있습니다. 한 번에 하나의 노트북에 하나의 오디오 개요만 있을 수 있습니다. 이 페이지에서는 오디오 개요를 만들고 삭제하는 방법을 설명합니다.

AI 오디오 오버뷰와 팟캐스트의 차이점

AI 음성 개요는 다음과 같은 점에서 팟캐스트와 다릅니다.

  • AI 오디오 오버뷰는 데이터 소스가 추가된 노트북과 연결되어야 합니다. 반면 팟캐스트는 NotebookLM Enterprise 노트북, Gemini Enterprise 라이선스 또는 데이터 스토어 없이 생성할 수 있습니다. 팟캐스트를 만들려면 사용 설정된 Google Cloud프로젝트와 팟캐스트 API 사용자 역할만 있으면 됩니다.
  • AI 음성 개요를 만들려면 notebooks.audioOverview 메서드를 호출합니다. 팟캐스트를 만들려면 독립형 API인 podcasts 메서드를 호출하세요.

AI 오디오 오버뷰 만들기

노트북의 콘텐츠에 대한 AI 음성 개요를 생성하려면 notebooks.audioOverviews.create 메서드를 호출합니다. 노트북당 하나의 AI 음성 개요만 있을 수 있으므로 이 메서드는 노트북에 기존 AI 음성 개요가 없는 경우에만 성공합니다.

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 멀티 리전의 경우 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"
    }
  }

AI 오디오 오버뷰를 생성하는 데 몇 분 정도 걸립니다.

생성된 AI 음성 개버뷰 확인하기

생성된 오디오 개요를 확인하려면 다음 단계를 따르세요.

  1. 노트북을 엽니다. 자세한 내용은 생성된 노트북에 액세스하기를 참고하세요.

  2. 노트북의 스튜디오에서 로드를 클릭하여 대화를 로드합니다. 개요를 로드하는 데 잠시 시간이 걸립니다.

    스튜디오에서 재생 속도 변경, AI 오디오 오버뷰 파일 다운로드 또는 삭제와 같은 작업을 통해 AI 오디오 오버뷰를 관리할 수 있습니다.

AI 오디오 오버뷰 삭제

기존 오디오 개요를 삭제하려면 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 멀티 리전의 경우 eu-
    • 전역 위치의 경우 global-
    자세한 내용은 데이터 스토어의 다중 리전 지정을 참고하세요.
  • PROJECT_NUMBER: Google Cloud 프로젝트 수입니다.
  • LOCATION: 데이터 스토어의 지리적 위치입니다(예: global). 자세한 내용은 위치를 참고하세요.
  • NOTEBOOK_ID: 노트북의 고유 식별자입니다.

요청이 성공하면 빈 JSON이 표시됩니다.