ציון נקודת קצה אזורית

‫Cloud Text-to-Speech מציע נקודות קצה של API אזוריות ורב-אזוריות: global, ‏us, ‏eu. אם משתמשים בנקודת קצה אזורית, הנתונים באחסון ובשימוש נשארים בגבולות האזוריים או היבשתיים של אירופה או ארה"ב, בהתאמה. אם אתם צריכים לשלוט במיקום של הנתונים כדי לעמוד בדרישות רגולטוריות מקומיות, חשוב לציין נקודת קצה. אין שינוי פונקציונלי בהתנהגות של ה-API.

עולמי

שם הדגם	עולמי
Gemini ‎2.5 Flash TTS (gemini-2.5-flash-tts)
Gemini ‎2.5 Flash TTS (gemini-2.5-pro-tts)
‫Chirp 3: קולות באיכות HD
‫Chirp 3: Instant Custom Voice

ארצות הברית

שם הדגם	ארה"ב במספר אזורים
Gemini ‎2.5 Flash TTS (gemini-2.5-flash-tts)
Gemini ‎2.5 Flash TTS (gemini-2.5-pro-tts)
‫Chirp 3: קולות באיכות HD
‫Chirp 3: Instant Custom Voice

אירופה

	מספר אזורים באיחוד האירופי	לונדון, בריטניה (europe-west2)	פרנקפורט, גרמניה (europe-west3)	איימסהאבן, הולנד (europe-west4)
Gemini ‎2.5 Flash TTS (gemini-2.5-flash-tts)
Gemini ‎2.5 Flash TTS (gemini-2.5-pro-tts)
‫Chirp 3: קולות באיכות HD
‫Chirp 3: Instant Custom Voice

אסיה ואזור האוקיינוס השקט

	טוקיו, יפן (asia-northeast1)	סידני, אוסטרליה (australia-southeast1)	מומבאי, הודו (asia-south1)	סינגפור (asia-southeast1)	סיאול, קוריאה (asia-northeast3)
Gemini ‎2.5 Flash TTS (gemini-2.5-flash-tts)
Gemini ‎2.5 Flash TTS (gemini-2.5-pro-tts)
‫Chirp 3: קולות באיכות HD
‫Chirp 3: Instant Custom Voice

שימוש בנקודות קצה אזוריות

כשמשתמשים בנקודת קצה אזורית, חשוב לכלול את המיקום התואם us או eu במחרוזת parent. מידע נוסף על הגדרת גוף הבקשה של הסינתזה מופיע במסמכי התיעוד של Synthesize.

פרוטוקול

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

במספר אזורים	שינוי נקודת הקצה
האיחוד האירופי	$ export CLOUD_TTS_ENDPOINT=https://eu-texttospeech.googleapis.com
ארה"ב	$ export CLOUD_TTS_ENDPOINT=https://us-texttospeech.googleapis.com

רק קולות Neural2 זמינים מנקודות הקצה האלה:

אזור יחיד	שינוי נקודת הקצה
US Central1	$ export CLOUD_TTS_ENDPOINT=https://us-central1-texttospeech.googleapis.com

בדוגמת הקוד הבאה אפשר לראות איך לשלוח בקשת synthesis request שבה כל הנתונים מוגבלים לאזור מסוים. אפשר להשתמש בנקודת הקצה האזורית EU או US במקום המשתנה CLOUD_TTS_ENDPOINT. מחליפים את PROJECT_ID במזהה הפרויקט.

$ curl   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "x-goog-user-project: PROJECT_ID" \
         -H "Content-Type: application/json; charset=utf-8" \
         --data "{
          'input':{
            'text':'Android is a mobile operating system developed by Google,
             based on the Linux kernel and designed primarily for
             touchscreen mobile devices such as smartphones and tablets.'
           },
          'voice':{
            'languageCode':'en-gb',
            'name':'en-GB-Neural2-A',
            'ssmlGender':'FEMALE'
          },
        'audioConfig':{
          'audioEncoding':'MP3'
        }
      }" $CLOUD_TTS_ENDPOINT/v1/text:synthesize > synthesize-text.txt

בדוגמה הזו נעשה שימוש ב-Google Cloud CLI כדי ליצור טוקן גישה לחשבון Google. הוראות להתקנת ה-CLI של gcloud מופיעות במאמר אימות ל-Cloud TTS.

הגבלת השימוש בנקודת קצה גלובלית של API

כדי לאכוף את השימוש בנקודות קצה אזוריות, אפשר להשתמש באילוץ constraints/gcp.restrictEndpointUsage של מדיניות הארגון כדי לחסום בקשות לנקודת קצה ל-API הגלובלית. מידע נוסף מופיע במאמר בנושא הגבלת השימוש בנקודות קצה.