# This file is used to generate README.rst

product:

name: Google Cloud Speech API

short_name: Cloud Speech API

url: https://cloud.google.com/speech/docs/

description: >

The `Google Cloud Speech API`_ enables easy integration of Google speech

recognition technologies into developer applications. Send audio and receive

a text transcription from the Cloud Speech API service.

setup:

- auth

- install_deps

samples:

- name: Quickstart

file: quickstart.py

cloud_client_library: true

def run_quickstart():

# [START speech_quickstart]

import io

import os

# Imports the Google Cloud client library

from google.cloud import speech

# Instantiates a client

speech_client = speech.Client()

# The name of the audio file to transcribe

file_name = os.path.join(

os.path.dirname(__file__),

'resources',

'audio.raw')

# Loads the audio into memory

with io.open(file_name, 'rb') as audio_file:

content = audio_file.read()

audio_sample = speech_client.sample(

content,

source_uri=None,

encoding='LINEAR16',

sample_rate=16000)

# Detects speech in the audio file

alternatives = speech_client.speech_api.sync_recognize(audio_sample)

for alternative in alternatives:

print('Transcript: {}'.format(alternative.transcript))

# [END speech_quickstart]

if __name__ == '__main__':

run_quickstart()

import quickstart

def test_quickstart(capsys):

quickstart.run_quickstart()

out, _ = capsys.readouterr()

assert 'Transcript: how old is the Brooklyn Bridge' in out