הודעות שגיאה

בדף הזה מפורטות שגיאות ב-Cloud Speech-to-Text, שהפתרונות שלהן דורשים יותר שלבים ממה שאפשר לתאר בהודעת שגיאה.

"פרטי הכניסה של Application Default Credentials לא זמינים"

אם קיבלתם את ההודעה הזו:

The Application Default Credentials are not available. They are
available if running in Google Compute Engine. Otherwise, the
environment variable GOOGLE_APPLICATION_CREDENTIALS must be defined
pointing to a file defining the credentials.
See https://developers.google.com/accounts/docs/application-default-credentials
for more information.

ב-Cloud STT נעשה שימוש ב-Application Default Credentials ‏(ADC) לאימות.

פרטי הכניסה ל-ADC צריכים להיות זמינים בהקשר שבו אתם שולחים קריאה ל-Cloud Speech-to-Text API. לדוגמה, אם הגדרתם את ADC במסוף אבל אתם מריצים את הקוד בכלי לניפוי באגים של ה-IDE, יכול להיות שלקונטקסט ההרצה של הקוד לא תהיה גישה לפרטי הכניסה. במקרה כזה, יכול להיות שהבקשה ל-Cloud STT תיכשל.

במאמר הגדרת Application Default Credentials מוסבר איך לספק פרטי כניסה ל-ADC.

"הקובץ ... (שמשתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS מפנה אליו) לא קיים!"

אם קיבלתם את ההודעה הזו:

ERROR: (gcloud.auth.application-default.print-access-token) File /path/to/key.json
(pointed by GOOGLE_APPLICATION_CREDENTIALS environment variable) does not exist!
{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "status": "PERMISSION_DENIED"
  }
}

מוודאים שיש לכם קובץ JSON תקין של מפתח חשבון שירות במיקום ששמור במשתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS, ושהמשתנה מצביע על המקום הנכון.

כדי לאבחן את השגיאה הזו, נסו לפתוח את קובץ המפתח של חשבון השירות מהתיקייה שממנה אתם מנסים לשלוח קריאה ל-Cloud Speech-to-Text API.

cat $GOOGLE_APPLICATION_CREDENTIALS

‫Forbidden: 403 POST API has not been used or is disabled (אסור: 403 POST API לא היה בשימוש או שהוא מושבת)

אם מופיעה ההודעה:

Forbidden: 403 POST Cloud Speech-to-Text API has not been used in
project # before or it is disabled.
Enable it by visiting [url] then retry.
If you enabled this API recently, wait a few minutes for the action to
propagate to our systems and retry.

1. נכנסים לקישור שמופיע בהודעת השגיאה ומפעילים את Cloud STT API. מחכים כמה דקות ומנסים שוב.
2. מוודאים שיש לכם קובץ JSON תקין של מפתח חשבון שירות שמאוחסן במשתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS. כדי לאבחן את השגיאה הזו, נסו לפתוח את קובץ המפתח של חשבון השירות מהתיקייה שממנה אתם מנסים לשלוח קריאה ל-Cloud Speech-to-Text API.

cat $GOOGLE_APPLICATION_CREDENTIALS

"חובה להשתמש באודיו בערוץ יחיד (מונו)"

אם קיבלתם את ההודעה הזו:

Must use single channel (mono) audio, but WAV header indicates 2
channels.

קובץ האודיו מכיל יותר מערוץ אחד. כדי לתמלל את קובץ האודיו הזה, צריך להצהיר שהאודיו כולל כמה ערוצים.

"Must use 16 bit samples for LINEAR_PCM"

אם קיבלתם את ההודעה הזו:

INVALID_ARGUMENT: Must use 16 bit samples for LINEAR_PCM, but the WAV
header indicates 8 bits per sample

יכול להיות שתצטרכו לשנות את הקידוד שציינתם ב-RecognitionConfig. במדריך בנושא קידודים מוסבר על הקידודים שנתמכים ב-Cloud STT.

"הקלט לסנכרון ארוך מדי"

אם קיבלתם את ההודעה הזו:

Sync input too long. For audio longer than 1 min use
LongRunningRecognize with a 'uri' parameter.

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

"הגדרת הזיהוי לא תקינה: קידוד שגוי"

אם קיבלתם את ההודעה הזו:

Invalid recognition 'config': bad encoding.

יכול להיות שנתוני האודיו לא מקודדים בצורה נכונה, או שהם מקודדים באמצעות קודק שונה מזה שהצהרתם עליו ב-RecognitionConfig. צריך לבדוק את קלט האודיו ולוודא שהשדה encoding מוגדר בצורה נכונה.

"גודל המטען הייעודי (payload) של הבקשה חורג מהמגבלה"

אם אתם מקבלים את אחת מההודעות האלה:

Request payload size exceeds the limit.

Inline audio exceeds duration limit. Please use a GCS URI.

חרגתם ממגבלת הגודל של 10MB לבקשה אחת שנשלחת ל-API באמצעות קובץ מקומי. כדי לעקוף את מגבלת הגודל של 10MB, אתם יכולים להעביר את קובץ האודיו לקטגוריה של Cloud Storage. מידע נוסף זמין בדף מכסות ומגבלות.

"חריגה מהמכסה"

אם קיבלתם את ההודעה הזו:

RESOURCE_EXHAUSTED: Quota exceeded.

הגעתם למגבלה של המכסה לדקה או המכסה היומית. בודקים את המכסות והמגבלות של השימוש ב-Cloud STT.

אתם יכולים לבקש להגדיל את המכסות באמצעות מסוףGoogle Cloud .