生成 Podcast (API 方法)

重要事項： 只有部分客戶可以存取 Podcast API。 Google Cloud如要瞭解詳情或註冊使用這項功能，請洽詢您的Google Cloud 業務代表。

Gemini Enterprise 提供 API，可根據來源文件生成 Podcast。輸出內容與使用者在筆記本中產生的播客非常相似。

透過 API 生成 Podcast 非常適合批次作業，例如您可能有數十或數百本書籍、文章或課程，並想為每項內容生成 Podcast。

Podcast API 是獨立的 API，也就是說，您不需要 NotebookLM Enterprise 筆記本、Gemini Enterprise 授權或資料儲存庫。您只需要已啟用的 Google Cloud 專案和 Podcast API 使用者角色。

輸入

API 的輸入內容是 context 元素陣列。這是生成 Podcast 的來源素材。輸入內容可以是文字、圖片、音訊和影片。內容陣列的總內容必須少於 100,000 個權杖。

如需支援的類型清單，請參閱本頁「Gemini 2.5 Flash」的圖片、文件、影片和音訊技術規格。

輸出

API 會輸出 MP3 格式的 Podcast。

事前準備

如要使用 API 生成 Podcast，必須符合下列條件：

• 已啟用 Discovery Engine API 的 Google Cloud 專案。 請參閱「建立專案並啟用 API」。

• Podcast API 使用者的身分與存取權管理 (IAM) 角色 (roles/discoveryengine.podcastApiUser)。如需授予角色的相關一般資訊，請參閱「設定 NotebookLM Enterprise」。

根據脈絡輸入內容生成 Podcast

使用下列指令呼叫 podcast 方法，生成 Podcast。

輸入內容為多媒體物件陣列，例如文字、圖片、音訊和影片片段。

REST

如要生成及匯出 Podcast，請按照下列步驟操作：

1. 執行下列 curl 指令：

   curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/podcasts" \
     -d '{
         "podcastConfig": {
           "focus": "FOCUS",
           "length": "LENGTH",
           "languageCode": "LANGUAGE_CODE"
         },
         "contexts": [
           {
             "text": "TEXT_CONTENT"
           },
           {
             "inlineData": {
               "mimeType": "MIME_TYPE",
               "data": "BASE64_ENCODED_DATA"
             }
           }
         ],
         "title": "PODCAST_TITLE",
         "description": "PODCAST_DESCRIPTION"
     }'
   

   更改下列內容：

   • PROJECT_ID：專案 ID。
   • FOCUS：提示，建議 Podcast 的主題。
   • LENGTH：有兩個選項：
     • SHORT (通常需要 4 到 5 分鐘)
     • STANDARD (通常約 10 分鐘，但如果資料集較小，時間可能會更短)
   • LANGUAGE_CODE：選用。指定 Podcast 的語言代碼。使用 BCP47 定義的語言標記。如果未提供語言代碼，系統會以英文生成 Podcast。
   • TEXT_CONTENT：要加入的文字內容。
   • inlineData：非文字媒體的物件。
   • MIME_TYPE：Blob 資料的 MIME 類型 (例如 「image/png」)。
   • BASE64_ENCODED_DATA：媒體資料的原始位元組 (採用 Base64 編碼)。
   • PODCAST_TITLE：Podcast 的名稱。這項資訊可供內部使用，您也可以選擇向使用者顯示。
   • PODCAST_DESCRIPTION：Podcast 的說明。這項資訊可供內部使用，您也可以選擇向使用者顯示。

   指令與結果範例

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/podcasts" \
   -d '{
       "podcastConfig": {
         "focus": "Can you talk about how to find a job in Google?",
         "length": "SHORT"
       },
       "contexts": [
         {
           "text": "Breaking into Google is a highly competitive endeavor, attracting millions of applicants globally due to its reputation as a top employer, its innovative work, and comprehensive perks. Success hinges on a multi-faceted approach, starting with meticulously tailored online applications that incorporate job description keywords for ATS and showcasing Googlyness—a blend of curiosity, collaborative spirit, and leadership potential. The rigorous, multi-stage interview process involves recruiter screens, behavioral interviews (often using the STAR method), and for technical roles, demanding coding challenges and system design questions that assess not just correct answers but also problem-solving thought processes and communication skills. Networking for referrals and informational interviews can significantly boost visibility, but ultimately, thorough preparation through mock interviews and platforms like LeetCode, combined with patience and resilience through the often lengthy process, are paramount for navigating this challenging but rewarding path."
         },
         {
           "inlineData": {
             "mimeType": "image/png",
             "data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII="
           }
         }
       ],
       "title": "Find a job at Google ",
       "description": "This podcast is based on a plain text document and an image that describe various aspects of getting a job at Google."
   }'
   
   {
   "name": "projects/123456/locations/global/operations/create-podcast-54321"
   }
   

   生成 Podcast 需要幾分鐘的時間。

2. 記下作業名稱，您需要在步驟 4 中下載 Podcast。在上述範例中，作業名稱為 projects/123456/locations/global/operations/create-podcast-54321。

3. 選用。輪詢 Podcast 建立作業的狀態。請參閱「取得長時間執行作業的詳細資料」。

4. 作業完成後，請執行下列 curl 指令下載 Podcast：

   curl -v \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://discoveryengine.googleapis.com/v1/OPERATION_NAME:download?alt=media" \
     --output FILENAME.mp3 -L
   

   更改下列內容：

   • OPERATION_NAME：您在步驟 2 中記下的作業名稱。
   • FILENAME：Podcast 的檔案名稱。

   這項指令會將 Podcast 下載到本機目錄中的 MP3 檔案。

   指令與結果範例

   curl -v \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://discoveryengine.googleapis.com/v1/projects/123456/locations/global/operations/create-podcast-54321:download?alt=media" \
     --output my-podcast.mp3 -L
     
   
   % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                  Dload  Upload   Total   Spent    Left  Speed
   0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0* Host discoveryengine.googleapis.com:443 was resolved.
     ...
   { [42044 bytes data]
   100 14.3M  100 14.3M    0     0  10.9M      0  0:00:01  0:00:01 --:--:-- 29.7M
   * Connection #0 to host discoveryengine.googleapis.com left intact
   

法規遵循

Podcast API 不符合客戶自行管理的加密金鑰 (CMEK) 規定，因此無法搭配 Gemini Enterprise 適用的 CMEK 使用。