יצירת פודקאסטים (שיטת API)

הוצאה משימוש: הפסקנו את התמיכה ב-Podcast API. ‫Google לא מוסיפה לקוחות חדשים לרשימת ההיתרים.

‫Gemini Enterprise מציע API שמאפשר ליצור פודקאסטים על סמך מסמכי מקור. הפלט דומה מאוד לפודקאסטים שמשתמשי קצה יכולים ליצור מתוך תיקיות ה-Notebook שלהם.

יצירת פודקאסטים באמצעות ה-API מתאימה במיוחד למשימות באצווה, שבהן יש לכם עשרות או מאות ספרים, מאמרים או קורסים, ואתם רוצים ליצור פודקאסט לכל אחד מהם.

‫Podcast API הוא API עצמאי. כלומר, לא צריך מחברת Gemini Notebook Enterprise, רישיון ל-Gemini Enterprise או מאגר נתונים. אתם רק צריכים פרויקט ב- Google Cloud שמופעל בו Podcast API, ואת התפקיד "משתמש ב-Podcast API".

כניסות קלט

הקלט ל-API הוא מערך של רכיבי context. זהו חומר המקור שממנו נוצר הפודקאסט. הקלט יכול להיות טקסט, תמונות, אודיו ווידאו. התוכן הכולל של מערך ההקשר חייב להיות קטן מ-100,000 טוקנים.

רשימה של סוגי הקבצים הנתמכים מופיעה במפרט הטכני של תמונות, מסמכים, וידאו ואודיו בדף הזה בנושא Gemini 2.5 Flash.

תשובה

הפלט מה-API הוא הפודקאסט, בפורמט MP3.

לפני שמתחילים

כדי ליצור פודקאסט באמצעות ה-API, אתם צריכים:

• פרויקט ב- Google Cloud שבו מופעל Discovery Engine API. יצירת פרויקט והפעלת ה-API

• התפקיד ניהול זהויות והרשאות גישה (IAM) של משתמש Podcast API‏ (roles/discoveryengine.podcastApiUser). מידע כללי על הקצאת תפקידים זמין במאמר הגדרת Gemini Notebook Enterprise.

יצירת פודקאסט מקלט של הקשר

כדי ליצור פודקאסט, משתמשים בפקודה הבאה כדי להפעיל את השיטה podcast.

הקלט הוא מערך של אובייקטים של מולטימדיה, כמו טקסט, תמונות, קטעי אודיו וסרטונים.

REST

כדי ליצור ולייצא פודקאסט, מבצעים את הפעולות הבאות:

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: מזהה הפרויקט.
   • ‫FOCUS: הנחיה שבה אתם מציעים את נושא הפודקאסט.
   • ‫LENGTH: יש שתי אפשרויות:
     • SHORT (בדרך כלל 4-5 דקות)
     • ‫STANDARD (בדרך כלל כ-10 דקות, אבל יכול להיות פחות אם מדובר במערכי נתונים קטנים יותר)
   • ‫LANGUAGE_CODE: אופציונלי. ציינו את קוד השפה של הפודקאסט. צריך להשתמש בתגי שפה שמוגדרים לפי BCP47. אם לא מציינים קוד שפה, הפודקאסט נוצר באנגלית.
   • ‫TEXT_CONTENT: תוכן הטקסט שרוצים לכלול.
   • ‫inlineData: אובייקט למדיה שאינה טקסט.
   • ‫MIME_TYPE: סוג ה-MIME של נתוני ה-BLOB (לדוגמה, "image/png").
   • ‫BASE64_ENCODED_DATA: הבייטים הגולמיים של נתוני המדיה בקידוד base64.
   • ‫PODCAST_TITLE: שם לפודקאסט. השם הזה יכול להיות לשימוש פנימי, או שאתם יכולים לבחור להציג אותו למשתמשי הקצה.
   • ‫PODCAST_DESCRIPTION: תיאור של הפודקאסט. השם יכול להיות לשימוש פנימי, או שאתם יכולים להציג אותו למשתמשי הקצה.

   דוגמה לפקודה ולתוצאה

   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"
   }
   

   יצירת הפודקאסט נמשכת כמה דקות.

2. חשוב לשים לב לשם הפעולה, כי תצטרכו אותו כדי להוריד את הפודקאסט בשלב 4. בדוגמה שלמעלה, שם הפעולה הוא projects/123456/locations/global/operations/create-podcast-54321.

3. זה שינוי אופציונלי. בודקים את הסטטוס של פעולת יצירת הפודקאסט. איך מקבלים פרטים על פעולה ממושכת

4. אחרי שהפעולה מסתיימת, מריצים את פקודת ה-curl הבאה כדי להוריד את הפודקאסט:

   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: שם קובץ לפודקאסט.

   הפקודה הזו מורידה את הפודקאסט לקובץ 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.