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

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

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

AI 오디오 오버뷰는 다음과 같은 점에서 팟캐스트와 다릅니다.

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

미국 멀티 리전 엔드포인트 사용

Gemini Notebook Enterprise 구독이 미국 멀티 리전에 있는 경우 이 페이지의 요청을 미국 멀티 리전 엔드포인트인 discoveryengine.us.rep.googleapis.com로 전송할 수 있습니다. 멀티 리전 엔드포인트는 요청을 처리하고 멀티 리전 내에서 TLS를 종료하므로 요청 데이터는 전송 중에 미국에 유지됩니다. 이 엔드포인트를 사용해도 노트북이 저장되는 위치는 변경되지 않습니다. 자세한 내용은 Google Cloud보안 가이드의 리전 및 멀티 리전 API 엔드포인트 개요를 참조하세요.

미국 멀티 리전 엔드포인트를 사용하려면 이 페이지의 각 요청 URL을 다음과 같이 변경합니다.

  1. ENDPOINT_LOCATION-discoveryengine.googleapis.com 호스트를 discoveryengine.us.rep.googleapis.com로 바꿉니다.

  2. LOCATION을 us로 설정합니다.

각 요청의 나머지 부분은 동일하게 유지됩니다. 구독의 멀티 리전을 선택하는 방법은 구독 가져오기를 참조하세요. 리전 및 멀티 리전 서비스 엔드포인트 목록은 가상 프라이빗 클라우드 가이드의 리전 및 멀티 리전 서비스 엔드포인트를 참조하세요.

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 오디오 오버뷰를 삭제하려면 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이 반환됩니다.