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

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

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: AI 오디오 오버뷰를 생성하려는 소스의 ID입니다. sourceIdsfield는 선택적 배열입니다. 소스 ID를 지정하지 않으면 노트북의 모든 소스가 사용됩니다. 소스 ID에 대한 자세한 내용은 노트북에서 데이터 소스 추가 및 관리 (API)를 참조하세요.
  • EPISODE_FOCUS: AI 오디오 오버뷰에서 강조표시해야 하는 주제 또는 콘텐츠를 설명하는 문자열입니다.
  • LANGUAGE_CODE: AI 오디오 오버뷰가 요청된 언어 코드입니다.

요청이 성공하면 다음과 비슷한 JSON 응답이 표시됩니다. 이 응답은 AI 오디오 오버뷰 생성이 진행 중임을 보여줍니다.

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

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

생성된 AI 오디오 오버뷰 확인

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

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

  2. 노트북의 스튜디오에서 로드를 클릭하여 대화를 로드합니다. AI 오디오 오버뷰를 로드하는 데 몇 초 정도 걸립니다.

    스튜디오에서 재생 속도 변경, AI 오디오 오버뷰 파일 다운로드 또는 삭제와 같은 작업으로 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이 표시됩니다.