@google-cloud/speech

Node.js client for Google Cloud Speech: Speech to text conversion powered by machine learning.

Showing:

Popularity

Downloads/wk

20K

GitHub Stars

617

Maintenance

Last Commit

1mo ago

Contributors

69

Package

Dependencies

7

License

Apache-2.0

Type Definitions

Not Found

Tree-Shakeable

No?

Reviews

Average Rating

5.0/51
Read All Reviews

Top Feedback

1Great Documentation
1Easy to Use

Readme

Google Cloud Platform logo

Cloud Speech: Node.js Client

release level npm version codecov

Cloud Speech Client Library for Node.js

A comprehensive list of changes in each version may be found in the CHANGELOG.

Read more about the client libraries for Cloud APIs, including the older Google APIs Client Libraries, in Client Libraries Explained.

Table of contents:

Quickstart

Before you begin

  1. Select or create a Cloud Platform project.
  2. Enable the Cloud Speech API.
  3. Set up authentication with a service account so you can access the API from your local workstation.

Installing the client library

npm install @google-cloud/speech

Using the client library

// Imports the Google Cloud client library
const speech = require('@google-cloud/speech');

// Creates a client
const client = new speech.SpeechClient();

async function quickstart() {
  // The path to the remote LINEAR16 file
  const gcsUri = 'gs://cloud-samples-data/speech/brooklyn_bridge.raw';

  // The audio file's encoding, sample rate in hertz, and BCP-47 language code
  const audio = {
    uri: gcsUri,
  };
  const config = {
    encoding: 'LINEAR16',
    sampleRateHertz: 16000,
    languageCode: 'en-US',
  };
  const request = {
    audio: audio,
    config: config,
  };

  // Detects speech in the audio file
  const [response] = await client.recognize(request);
  const transcription = response.results
    .map(result => result.alternatives[0].transcript)
    .join('\n');
  console.log(`Transcription: ${transcription}`);
}
quickstart();

Samples

Samples are in the samples/ directory. Each sample's README.md has instructions for running its sample.

SampleSource CodeTry it
Microphone streamsource codeOpen in Cloud Shell
Beta Featuressource codeOpen in Cloud Shell
Export-to-storage.v1p1beta1source codeOpen in Cloud Shell
Infinite Streamingsource codeOpen in Cloud Shell
Model Adaptationsource codeOpen in Cloud Shell
Multi Regionsource codeOpen in Cloud Shell
Profanity Filtersource codeOpen in Cloud Shell
Quickstartsource codeOpen in Cloud Shell
Recognizesource codeOpen in Cloud Shell
Recognize speech with metadatasource codeOpen in Cloud Shell
Transcribe Context Classessource codeOpen in Cloud Shell

The Cloud Speech Node.js Client API Reference documentation also contains samples.

Supported Node.js Versions

Our client libraries follow the Node.js release schedule. Libraries are compatible with all current active and maintenance versions of Node.js.

Client libraries targeting some end-of-life versions of Node.js are available, and can be installed via npm dist-tags. The dist-tags follow the naming convention legacy-(version).

Legacy Node.js versions are supported as a best effort:

  • Legacy versions will not be tested in continuous integration.
  • Some security patches may not be able to be backported.
  • Dependencies will not be kept up-to-date, and features will not be backported.

Legacy tags available

  • legacy-8: install client libraries from this dist-tag for versions compatible with Node.js 8.

Versioning

This library follows Semantic Versioning.

This library is considered to be General Availability (GA). This means it is stable; the code surface will not change in backwards-incompatible ways unless absolutely necessary (e.g. because of critical security issues) or with an extensive deprecation period. Issues and requests against GA libraries are addressed with the highest priority.

More Information: Google Cloud Platform Launch Stages

Contributing

Contributions welcome! See the Contributing Guide.

Please note that this README.md, the samples/README.md, and a variety of configuration files in this repository (including .nycrc and tsconfig.json) are generated from a central template. To edit one of these files, make an edit to its templates in directory.

License

Apache Version 2.0

See LICENSE

Rate & Review

Great Documentation1
Easy to Use1
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
BangViet Nam1 Rating0 Reviews
3 days ago
Easy to Use
Great Documentation

Alternatives

googleapisGoogle's officially supported Node.js client library for accessing Google APIs. Support for authorization and authentication with OAuth 2.0, API Keys and JWT (Service Tokens) is included.
User Rating
4.7/ 5
39
Top Feedback
21Great Documentation
19Easy to Use
16Performant
GitHub Stars
10K
Weekly Downloads
853K
@google-cloud/firestoreNode.js client for Google Cloud Firestore: a NoSQL document database built for automatic scaling, high performance, and ease of application development.
User Rating
4.7/ 5
3
Top Feedback
2Great Documentation
2Easy to Use
2Slow
GitHub Stars
544
Weekly Downloads
1M
google-auth-library🔑 Google Auth Library for Node.js
User Rating
4.0/ 5
2
Top Feedback
2Great Documentation
1Easy to Use
GitHub Stars
1K
Weekly Downloads
5M
@google-cloud/storageNode.js client for Google Cloud Storage: unified object storage for developers and enterprises, from live data serving to data analytics/ML to data archiving.
User Rating
4.0/ 5
2
Top Feedback
2Performant
2Highly Customizable
1Great Documentation
GitHub Stars
670
Weekly Downloads
2M
@google-cloud/translateNode.js client for Google Cloud Translate: Dynamically translate text between thousands of language pairs.
User Rating
5.0/ 5
1
Top Feedback
N/A
GitHub Stars
470
Weekly Downloads
54K
gl
google-libphonenumberThe up-to-date and reliable Google's libphonenumber package for node.js.
User Rating
4.5/ 5
4
Top Feedback
2Great Documentation
2Easy to Use
2Performant
GitHub Stars
1K
Weekly Downloads
794K
See 18 Alternatives

Tutorials

No tutorials found
Add a tutorial