speech-use

Original：🇺🇸 English

Translated

3 scriptsChecked / no sensitive code detected

Generate (TTS), Transcribe (STT), and Clone voices using Google's GenAI and Cloud Speech SDKs. Supports Gemini-TTS, Chirp 3, and Instant Custom Voice.

1installs

Sourcecnemri/google-genai-skills

Added on2026-02-08

NPX Install

npx skill4agent add cnemri/google-genai-skills speech-use

SKILL.md Content

View Translation Comparison →

Speech Use

Use this skill to perform Text-to-Speech (TTS), Speech-to-Text (STT), and Voice Cloning operations.

This skill uses portable Python scripts managed by

uv

.

Prerequisites

Environment Variables:
- ```
GOOGLE_API_KEY
```
  (for TTS via Gemini)
- ```
GOOGLE_CLOUD_PROJECT
```
  (Required for STT and Voice Cloning)
- ```
GOOGLE_APPLICATION_CREDENTIALS
```
  (Recommended for STT/Voice Cloning)
APIs Enabled:
- Text-to-Speech API (
```
texttospeech.googleapis.com
```
  )
- Speech-to-Text API (
```
speech.googleapis.com
```
  )

Usage

1. Generate Speech (TTS)

Generate audio from text using Gemini-TTS.

Standard Voice:

bash

uv run skills/speech-use/scripts/generate_speech.py "Hello world, this is a test." --voice Puck --output hello.wav

Custom Voice (Cloned):

bash

uv run skills/speech-use/scripts/generate_speech.py "This is my custom voice speaking." --voice-cloning-key "YOUR_KEY_HERE" --output custom.wav

2. Create Custom Voice (Voice Cloning)

Generate a

voiceCloningKey

from a reference audio file and a consent file.

Requirements:

```
reference.wav
```
: 10-30s of clear speech (the voice to clone).
```
consent.wav
```
: The speaker saying: "I am the owner of this voice and I consent to Google using this voice to create a synthetic voice model."

bash

uv run skills/speech-use/scripts/create_custom_voice.py --reference-audio reference.wav --consent-audio consent.wav

Save the output key to use with
generate_speech.py
.

3. Transcribe Audio (STT)

Transcribe audio files using Chirp 3.

bash

uv run skills/speech-use/scripts/transcribe_audio.py audio.wav --language en-US --output transcript.txt

Options

generate_speech.py

```
--voice
```
: Prebuilt voice (e.g.,
```
Kore
```
,
```
Puck
```
,
```
Fenrir
```
,
```
Aoede
```
).

--voice-cloning-key

: Key from

create_custom_voice.py

.

```
--model
```
: Default
```
gemini-2.5-flash-preview-tts
```
.

transcribe_audio.py

```
--model
```
: Default
```
chirp_3
```
.
```
--language
```
: Default
```
auto
```
.
```
--location
```
: Cloud region (default
```
us
```
).

References

Before running scripts, review the reference guides for available voices and options.

Voices Guide - 30+ voice options with styles (Puck, Kore, Fenrir, Aoede, etc.)

speech-use

NPX Install

Tags

SKILL.md Content

Speech Use

Prerequisites

Usage

1. Generate Speech (TTS)

2. Create Custom Voice (Voice Cloning)

3. Transcribe Audio (STT)

Options

References