GSP119

Огляд

Speech-to-Text API забезпечує зручну інтеграцію технологій розпізнавання мовлення Google із додатками розробників, а також дає змогу надсилати аудіофайли й отримувати із сервісу транскрибований текст.

Завдання курсу

Під час цього практичного заняття ви навчитеся виконувати наведені нижче дії.

• Створіть ключ API.
• Створювати запит до Speech-to-Text API
• Виконувати запит до Speech-to-Text API

Налаштування й вимоги

Перш ніж натиснути кнопку Start Lab (Почати практичну роботу)

Ознайомтеся з наведеними нижче вказівками. На виконання практичного заняття відводиться обмежений час, і його не можна призупинити. Щойно ви натиснете Почати заняття, з’явиться таймер, який показуватиме, скільки часу для роботи з ресурсами Google Cloud у вас залишилося.

Ви зможете виконати практичне заняття в дійсному робочому хмарному середовищі (не в симуляції або демонстраційному середовищі). Для цього на час практичного заняття вам надаються тимчасові облікові дані для реєстрації і входу в Google Cloud.

Для цього практичного заняття потрібно мати:

• стандартний вебпереглядач, наприклад Chrome (рекомендовано);

Примітка. Виконуйте практичне заняття в анонімному вікні вебпереглядача (рекомендовано). Так ви уникнете додаткової плати, що може стягуватися з вашого особистого облікового запису внаслідок його помилкового використання замість облікового запису для навчання.

• достатню кількість часу, оскільки почавши практичне заняття, ви не зможете призупинити його.

Примітка. Для виконання цього практичного заняття використовуйте лише обліковий запис для навчання, оскільки з іншого облікового запису Google Cloud може стягуватися плата.

Як почати практичне заняття й увійти в консоль Google Cloud

1. Натисніть кнопку Почати заняття. Якщо за практичне заняття необхідно заплатити, відкриється вікно, де ви зможете обрати спосіб оплати. Праворуч розміщено панель Lab setup and access (Налаштування практичного заняття й доступ до нього) з такими даними:

   • кнопка Open Google Cloud console (Відкрити консоль Google Cloud);
   • тимчасові облікові дані (ім’я користувача й пароль) для доступу до цього практичного заняття;
   • інша необхідна для виконання цього практичного заняття інформація.

   Зверніть увагу, що таймер практичного заняття розташовано вгорі сторінки й на ньому відображається час, що залишився.

2. Натисніть Open Google Cloud console (Відкрити консоль Google Cloud) або натисніть правою кнопкою миші й виберіть Відкрити анонімне вікно, якщо ви використовуєте вебпереглядач Chrome.

   Завантажаться необхідні ресурси. Потім відкриється нова вкладка зі сторінкою входу.

   Порада. Упорядковуйте вкладки в окремих вікнах, розміщуючи їх поруч.

   Примітка. Якщо з’явиться вікно Choose an account (Виберіть обліковий запис), натисніть Use Another Account (Увійти в інший обліковий запис).

3. За потреби скопіюйте значення в полі Username (Ім’я користувача) нижче й вставте його у вікні Sign in (Вхід).

   {{{user_0.username | "Username"}}}

   Поле Username (Ім’я користувача) також можна знайти на панелі Lab setup and access (Налаштування практичного заняття й доступ до нього).

4. Натисніть Next (Далі).

5. Скопіюйте значення в полі Password (Пароль) нижче й вставте його у вікні Welcome (Вітаємо).

   {{{user_0.password | "Password"}}}

   Поле Password (Пароль) також можна знайти на панелі Lab setup and access (Налаштування практичного заняття й доступ до нього).

6. Натисніть Next (Далі).

   Важливо. Обов’язково використовуйте облікові дані, призначені для відповідного практичного заняття. Не використовуйте облікові дані Google Cloud. Примітка. Якщо ввійти у власний обліковий запис Google Cloud, може стягуватися додаткова плата.

7. Що від вас очікується

   • Прийміть Умови використання.
   • Не додавайте способи відновлення й двохетапну перевірку (оскільки це тимчасовий обліковий запис).
   • Не реєструйте безкоштовні пробні версії.

Через кілька секунд консоль Google Cloud відкриється в новій вкладці.

Примітка. Щоб отримати доступ до продуктів і сервісів Google Cloud, натисніть меню навігації або введіть назву сервісу чи продукту в полі пошуку.

Як активувати Cloud Shell

Cloud Shell – це віртуальна машина з попередньо завантаженими інструментами для розробників. Вона містить головний каталог обсягом 5 ГБ постійної пам’яті й працює в середовищі Google Cloud. Cloud Shell надає доступ до ресурсів Google Cloud через командний рядок.

1. Угорі консолі Google Cloud натисніть Activate Cloud Shell (Активувати Cloud Shell) .

2. У вікнах, що відкриються, виконайте наведені нижче дії.

   • У вікні з інформацією про Cloud Shell натисніть Continue (Далі).
   • Дозвольте Cloud Shell використовувати ваші облікові дані, щоб здійснювати виклики Google Cloud API.

Щойно ви підключитеся, вас буде автентифіковано, а проєкт отримає ваш Project_ID (Ідентифікатор проєкту) – . Вивід міститиме рядок зі значенням Project_ID (Ідентифікатор проєкту) для цього сеансу:

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud – це інструмент командного рядка для Google Cloud. Він входить у пакет Cloud Shell і підтримує функцію автозавершення клавішею TAB.

3. (Необов’язково) Щоб вивести поточне ім’я облікового запису, введіть таку команду:

gcloud auth list

4. Натисніть Authorize (Авторизувати).

Вивід:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (Необов’язково) Щоб вивести ідентифікатор проєкту, введіть таку команду:

gcloud config list project

Вивід:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Примітка. Щоб знайти повну документацію щодо gcloud, перегляньте посібник з інтерфейсу командного рядка gcloud у Google Cloud.

Завдання 1. Створіть ключ API

Оскільки ви надсилатимете запит до Speech-to-Text API за допомогою команди curl, вам потрібно згенерувати ключ API, який передаватиметься в URL-адресі цього запиту.

1. Для цього натисніть меню навігації > APIs & services (API і сервіси) > Credentials (Облікові дані).

2. Натисніть + Create credentials (+ Створити облікові дані).

3. У спадному меню виберіть API key (Ключ API).

4. На бічній панелі Create API key (Створити ключ API) у розділі APIs that can be accessed using this key (API, до яких можна отримати доступ за допомогою цього ключа) натисніть спадне меню (Select API restrictions (Виберіть обмеження API)).

5. Поставте прапорець біля Cloud Speech-to-Text API і натисніть OK.

6. Натисніть Створити.

7. Скопіюйте щойно згенерований ключ і натисніть Close (Закрити).

8. У Cloud Shell збережіть ключ API як змінну середовища. Для цього введіть наведений нижче код і замініть <YOUR_API_KEY> на скопійований ключ.

export API_KEY=<YOUR_API_KEY>

Щоб підтвердити виконання завдання, натисніть Підтвердити виконання.

Створіть ключ API

Завдання 2. Створіть запит до Speech-to-Text API

Примітка. Скористайтеся попередньо записаним файлом, доступним у Cloud Storage за цим посиланням: gs://cloud-samples-tests/speech/brooklyn.flac. Прослухайте аудіофайл, перш ніж надсилати його до Speech-to-Text API.

1. Створіть файл request.json у Cloud Shell. За допомогою цього файлу ви надішлете свій запит до Speech-to-Text API.

touch request.json

2. Відкрийте файл request.json:

nano request.json Примітка. Ви можете використовувати редактор для командного рядка, у якому вам зручно працювати (наприклад, Nano, Vim чи Emacs), або gcloud. У цій практичній роботі надано вказівки для текстового редактора Nano.

3. Додайте наведений нижче фрагмент коду у файл request.json зі значенням uri для тестового необробленого аудіофайлу.

{ "config": { "encoding":"FLAC", "languageCode": "en-US" }, "audio": { "uri":"gs://cloud-samples-tests/speech/brooklyn.flac" } }

4. Натисніть CTRL+X, Y, ENTER, щоб закрити файл request.json.

У тілі запиту містяться об’єкти config і audio.

В об’єкті config ви вказуєте, як Speech-to-Text API має обробити запит. Параметр encoding надає API інформацію про тип аудіокодування для файлу, який ви надсилаєте. FLAC – це тип кодування для файлів із розширенням .raw. Докладніше про типи кодування можна дізнатися в посібнику з RecognitionConfig.

Ви також можете додати інші параметри в об’єкт config, але лише параметр encoding є обов’язковим.

За допомогою об’єкта audio ви передаєте API параметр uri для аудіофайлу в Cloud Storage.

Час виконати запит до Speech-to-Text API.

Завдання 3. Виконайте запит до Speech-to-Text API

1. Передайте тіло запиту разом зі змінною середовища ключа API до Speech-to-Text API за допомогою команди curl (в одному командному рядку):

curl -s -X POST -H "Content-Type: application/json" --data-binary @request.json \ "https://speech.googleapis.com/v1/speech:recognize?key=${API_KEY}"

Вивід виглядатиме приблизно так:

{ "results": [ { "alternatives": [ { "transcript": "how old is the Brooklyn Bridge", "confidence": 0.9311077 } ], "resultEndTime": "1.770s", "languageCode": "en-us" } ], "totalBilledTime": "2s", "requestId": "1573191382345569448" }

Значення transcript поверне від Speech-to-Text API транскрибований текст вашого аудіофайлу, а значення confidence указуватиме, наскільки точно транскрибовано цей файл.

У запиті вище ви використовували метод syncrecognize. Speech-to-Text API підтримує синхронне й асинхронне перетворення мовлення на текст. У цьому прикладі ви надіслали окремий аудіофайл, але за допомогою методу syncrecognize можна також виконувати потокове транскрибування мовлення користувача.

Ви створили запит до Speech-to-Text API і виконали його.

2. Виконайте наведену нижче команду, щоб зберегти відповідь у файлі result.json.

curl -s -X POST -H "Content-Type: application/json" --data-binary @request.json \ "https://speech.googleapis.com/v1/speech:recognize?key=${API_KEY}" > result.json

3. Завантажте файл result.json у сегмент Cloud Storage.

gcloud storage cp result.json gs://{{{project_0.project_id | PROJECT_ID}}}-speech/

Щоб підтвердити виконання завдання, натисніть Підтвердити виконання.

Виконайте запит до Speech-to-Text API і збережіть результат

Вітаємо!

Ви отримали транскрибований текст з аудіофайлу за допомогою Speech-to-Text API.

Наступні кроки/Докладніше

Це заняття також входить до низки практичних занять під назвою Qwik Starts. Вони призначені для ознайомлення з функціями Google Cloud. Такі практичні роботи можна знайти в каталозі за запитом "Qwik Starts".

Навчання й сертифікація Google Cloud

…допомагають ефективно використовувати технології Google Cloud. Наші курси передбачають опанування технічних навичок, а також ознайомлення з рекомендаціями, що допоможуть вам швидко зорієнтуватися й вивчити матеріал. Ми пропонуємо курси різних рівнів – від базового до високого. Ви можете вибрати формат навчання (за запитом, онлайн або офлайн) відповідно до власного розкладу. Пройшовши сертифікацію, ви перевірите й підтвердите свої навички та досвід роботи з технологіями Google Cloud.

Посібник востаннє оновлено 1 жовтня 2026 року

Практичне заняття востаннє протестовано 1 жовтня 2026 року

© Google LLC 2026. Усі права захищено. Назва та логотип Google є торговельними марками Google LLC. Усі інші назви компаній і продуктів можуть бути торговельними марками відповідних компаній, з якими вони пов’язані.