GSP119

Genel Bakış

Speech-to-Text API, Google konuşma tanıma teknolojilerinin geliştirici uygulamalarına kolayca entegre edilmesini sağlar. Speech-to-Text API, hizmete ses gönderip transkript almanıza olanak tanır.

Neler öğreneceksiniz?

Bu laboratuvarda şunları öğreneceksiniz:

• API anahtarı oluşturma
• Speech-to-Text API isteği oluşturma
• Speech-to-Text API'yi çağırma

Kurulum ve şartlar

Laboratuvarı Başlat düğmesini tıklamadan önce

Buradaki talimatları okuyun. Laboratuvarlar süreli olduğundan duraklatılamaz. Start Lab'i (Laboratuvarı başlat) tıkladığınızda başlayan zamanlayıcı, Google Cloud kaynaklarının ne süreyle kullanımınıza açık durumda kalacağını gösterir.

Bu uygulamalı laboratuvarı kullanarak, laboratuvar etkinliklerini simülasyon veya demo ortamı yerine gerçek bir bulut ortamında gerçekleştirebilirsiniz. Bunu yapabilmeniz için size yeni, geçici kimlik bilgileri verilir. Bu kimlik bilgilerini laboratuvar süresince Google Cloud'da oturum açmak ve Google Cloud'a erişmek için kullanabilirsiniz.

Bu laboratuvarı tamamlamak için gerekenler:

• Standart bir internet tarayıcısına erişim (Chrome Tarayıcı önerilir)

Not: Bu laboratuvarı çalıştırmak için tarayıcıyı gizli modda (önerilen) veya gizli tarama penceresinde açın. Aksi takdirde, kişisel hesabınızla öğrenci hesabınız arasında oluşabilecek çakışmalar nedeniyle kişisel hesabınızdan ek ücret alınabilir.

• Laboratuvarı tamamlamak için yeterli süre (Laboratuvarlar başlatıldıktan sonra duraklatılamaz.)

Not: Bu laboratuvar için yalnızca öğrenci hesabını kullanın. Farklı bir Google Cloud hesabı kullanırsanız bu hesaptan ödeme alınabilir.

Laboratuvarınızı başlatma ve Google Cloud konsolunda oturum açma

1. Start Lab (Laboratuvarı Başlat) düğmesini tıklayın. Laboratuvar için ödeme yapmanız gerekiyorsa ödeme yöntemini seçebileceğiniz bir iletişim kutusu açılır. Sağdaki Lab setup and access (Laboratuvar kurulumu ve erişimi) panelinde şunlar yer alır:

   • Open Google Cloud console (Google Cloud konsolunu aç) düğmesi
   • Bu laboratuvarda kullanmanız gereken geçici kimlik bilgileri (kullanıcı adı ve şifre)
   • Bu laboratuvarda ilerlemek için gerekebilecek diğer bilgiler

   Laboratuvar zamanlayıcısının sayfanın üst kısmına yakın bir yerde bulunduğunu ve kalan süreyi gösterdiğini unutmayın.

2. Open Google Cloud console'u (Google Cloud konsolunu aç) tıklayın (veya Chrome Tarayıcı'yı kullanıyorsanız sağ tıklayıp Bağlantıyı gizli pencerede aç'ı seçin).

   Laboratuvar, kaynakları çalıştırır ve sonra "Oturum açın" sayfasını gösteren başka bir sekme açar.

   İpucu: Sekmeleri ayrı pencerelerde, yan yana açın.

   Not: Bir hesap seçin iletişim kutusunu görürseniz Başka bir hesap kullan'ı tıklayın.

3. Gerekirse aşağıdaki kullanıcı adını kopyalayıp Oturum açın iletişim kutusuna yapıştırın.

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

   Kullanıcı adını Lab setup and access (Laboratuvar kurulumu ve erişimi) panelinde de bulabilirsiniz.

4. Next'i (Sonraki) tıklayın.

5. Aşağıdaki şifreyi kopyalayıp Welcome (Hoş geldiniz) iletişim kutusuna yapıştırın.

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

   Şifreyi Lab setup and access (Laboratuvar kurulumu ve erişimi) panelinde de bulabilirsiniz.

6. Next'i (Sonraki) tıklayın.

   Önemli: Laboratuvarın sizinle paylaştığı giriş bilgilerini kullanmanız gerekir. Google Cloud hesabınızın kimlik bilgilerini kullanmayın. Not: Bu laboratuvarda kendi Google Cloud hesabınızı kullanabilmek için ek ücret ödemeniz gerekebilir.

7. Sonraki sayfalarda ilgili düğmeleri tıklayarak ilerleyin:

   • Hüküm ve koşulları kabul edin.
   • Geçici bir hesap kullandığınızdan, kurtarma seçenekleri veya iki faktörlü kimlik doğrulama eklemeyin.
   • Ücretsiz denemelere kaydolmayın.

Birkaç saniye sonra Google Cloud konsolu bu sekmede açılır.

Not: Google Cloud ürün ve hizmetlerine erişmek için gezinme menüsünü tıklayın veya Search (Arama) alanına hizmetin veya ürünün adını yazın.

Cloud Shell'i etkinleştirme

Cloud Shell, çok sayıda geliştirme aracı içeren bir sanal makinedir. 5 GB boyutunda kalıcı bir ana dizin sunar ve Google Cloud üzerinde çalışır. Cloud Shell, Google Cloud kaynaklarınıza komut satırı erişimi sağlar.

1. Google Cloud konsolunun üst kısmından Activate Cloud Shell (Cloud Shell'i etkinleştir) simgesini tıklayın.

2. Aşağıdaki pencereleri tıklayın:

   • Cloud Shell bilgi penceresinde devam edin.
   • Google Cloud API çağrıları yapmak için Cloud Shell'e kimlik bilgilerinizi kullanma yetkisi verin.

Bağlandığınızda kimliğiniz zaten doğrulanmıştır. Proje ise Project_ID'nize () göre ayarlanmıştır. Çıkış, bu oturum için Project_ID'yi tanımlayan bir satır içerir:

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

gcloud, Google Cloud'un komut satırı aracıdır. Cloud Shell'e önceden yüklenmiştir ve sekmeyle tamamlamayı destekler.

3. (İsteğe bağlı) Etkin hesap adını şu komutla listeleyebilirsiniz:

gcloud auth list

4. Authorize'ı (Yetkilendir) tıklayın.

Çıkış:

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

5. (İsteğe bağlı) Proje kimliğini şu komutla listeleyebilirsiniz:

gcloud config list project

Çıkış:

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} Not: gcloud ile ilgili tüm belgeleri, Google Cloud'daki gcloud CLI'a genel bakış rehberinde bulabilirsiniz.

1. görev: API anahtarı oluşturma

Speech-to-Text API'ye istek göndermek için curl kullanacağınızdan istek URL'sini iletmek için bir API anahtarı oluşturmanız gerekecektir.

1. API anahtarı oluşturmak için Gezinme menüsü > API'ler ve hizmetler > Kimlik bilgileri'ni tıklayın.

2. + Create credentials'ı (Kimlik bilgileri oluştur) tıklayın.

3. Açılır menüden API key'i (API anahtarı) seçin.

4. Create API key (API anahtarı oluştur) yan panelindeki APIs that can be accessed using this key (Bu anahtarla erişilebilen API'ler) bölümünde açılır menüyü tıklayın (API kısıtlamalarını seçin).

5. Cloud Speech-to-Text API için kutuyu işaretleyip OK'i (Tamam) tıklayın.

6. Oluştur'u tıklayın.

7. Oluşturduğunuz anahtarı kopyalayıp Close'u (Kapat) tıklayın.

8. Cloud Shell'de, <YOUR_API_KEY> kısmını az önce kopyaladığınız anahtarla değiştirerek aşağıdaki komutu girin ve API anahtarını bir ortam değişkenine kaydedin:

export API_KEY=<YOUR_API_KEY>

Hedefi doğrulamak için İlerleme durumumu kontrol et'i tıklayın.

API anahtarı oluşturma

2. görev: Speech-to-Text API isteğinizi oluşturma

Not: Cloud Storage'da mevcut olan önceden kaydedilmiş bir dosyayı kullanacaksınız: gs://cloud-samples-tests/speech/brooklyn.flac. Speech-to-Text API'ye göndermeden önce ses dosyasını dinleyin.

1. Cloud Shell'de request.json dosyasını oluşturun. Speech-to-Text API'ye yönelik isteğinizi oluşturmak için bu dosyayı kullanacaksınız:

touch request.json

2. request.json dosyasını açın:

nano request.json Not: Tercih ettiğiniz komut satırı düzenleyiciyi (nano, vim, emacs) veya gcloud'u kullanabilirsiniz. Bu laboratuvarda, nano ile ilgili talimatlar sağlanmaktadır.

3. Örnek RAW ses dosyasının request.json değerini kullanarak aşağıdaki kodu request.json dosyanıza ekleyin:

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

4. request.json dosyasını kapatmak için CTRL+X, Y, ENTER tuşlarına basın.

İsteğin gövdesinde bir config ve audio nesnesi bulunur.

config'de, Speech-to-Text API'nin isteği nasıl işleyeceğini belirtirsiniz. encoding parametresi, dosya API'ye gönderilirken kullanılan ses kodlama türünü API'ye bildirir. FLAC, .raw dosyaları için kullanılan kodlama türüdür. Kodlama türleri hakkında daha fazla bilgiye RecognitionConfig Kılavuzu'ndan ulaşabilirsiniz.

config nesnenize ekleyebileceğiniz başka parametreler de vardır ancak yalnızca encoding parametresi zorunludur.

audio nesnesinde, Cloud Storage'daki ses dosyasının URI'sını API'ye iletirsiniz.

Artık Speech-to-Text API'yi çağırmaya hazırsınız.

3. görev: Speech-to-Text API'yi çağırma

1. Aşağıdaki curl komutunu kullanarak isteğinizin gövdesini, API anahtarı ortam değişkeniyle birlikte Speech-to-Text API'ye iletin (hepsi tek bir komut satırında):

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

Yanıtınızın görünümü aşağıdaki gibi olacaktır:

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

transcript değeri, Speech-to-Text API'nin ses dosyanızla ilişkili olarak ürettiği transkripti döndürür. confidence değeri ise API'nin, ses dosyanızın transkriptinin doğruluğundan ne kadar emin olduğunu gösterir.

Yukarıdaki istekte syncrecognize yöntemini çağırdığınızı fark etmişsinizdir. Speech-to-Text API hem eşzamanlı hem de eşzamansız sesle yazma transkriptini destekler. Bu örnekte, ses dosyasının tamamını gönderdiniz ancak syncrecognize yöntemini, kullanıcı konuşmaya devam ederken canlı sesle yazma transkripti üretmek için de kullanabilirsiniz.

Speech-to-Text API isteği oluşturdunuz, ardından Speech-to-Text API'yi çağırdınız.

2. Yanıtı bir result.json dosyasına kaydetmek için aşağıdaki komutu çalıştırın:

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 dosyasını Cloud Storage paketinize yükleyin:

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

Hedefi doğrulamak için İlerleme durumumu kontrol et'i tıklayın.

Speech-to-Text API'yi çağırın ve sonucu kaydedin

Tebrikler!

Giriş ses dosyasının transkriptini almak için Speech-to-Text API'yi kullandınız.

Sonraki adımlar/Daha fazla bilgi

Bu laboratuvar, Qwik Starts laboratuvar serisinin de bir parçasıdır. Bu laboratuvarlar, Google Cloud'daki pek çok özelliği biraz olsun tanıtabilmek amacıyla tasarlanmıştır. Katılabileceğiniz bir sonraki laboratuvarı bulmak için laboratuvar kataloğunda "Qwik Starts" araması yapın.

Google Cloud eğitimi ve sertifikası

...Google Cloud teknolojilerinden en iyi şekilde yararlanmanıza yardımcı olur. Derslerimizde teknik becerilere odaklanırken en iyi uygulamalara da yer veriyoruz. Gerekli yetkinlik seviyesine hızlıca ulaşmanız ve öğrenim maceranızı sürdürebilmeniz için sizlere yardımcı olmayı amaçlıyoruz. Temel kavramlardan ileri seviyeye kadar farklı eğitim programlarımız mevcut. Ayrıca, yoğun gündeminize uyması için talep üzerine sağlanan, canlı ve sanal eğitim alternatiflerimiz de var. Sertifikasyonlar ise Google Cloud teknolojilerindeki becerilerinizi ve uzmanlığınızı doğrulamanıza ve kanıtlamanıza yardımcı oluyor.

Kılavuzun Son Güncellenme Tarihi: 1 Ekim 2026

Laboratuvarın Son Test Edilme Tarihi: 1 Ekim 2026

Telif Hakkı 2026 Google LLC. Tüm hakları saklıdır. Google ve Google logosu, Google LLC şirketinin ticari markalarıdır. Diğer tüm şirket ve ürün adları ilişkili oldukları şirketlerin ticari markaları olabilir.