sample_gemini_tts.py ダウンロード/コピー
sample_gemini_tts.py
sample_gemini_tts.py
1"""
2Gemini TTSライブラリの基本的な使用例を示すスクリプト。
3
4このスクリプトは、`tktts_gemini` ライブラリを使用して、
5Google Gemini Text-to-Speech (TTS) サービスとのインタラクションをデモンストレーションします。
6主に、APIキーの設定、利用可能な音声のリスト表示、
7そして単一のテキストから音声ファイルを生成する機能に焦点を当てています。
8スクリプトを実行する前に、環境変数 `GEMINI_API_KEY` を設定してください。
9
10:doc:`sample_gemini_tts_usage`
11"""
12
13import os
14import tktts_gemini as tts
15
16# APIキーの確認(あらかじめ環境変数にセットしてください)
17if not os.environ.get("GEMINI_API_KEY"):
18 google_key = os.environ.get("GOOGLE_API_KEY")
19 if google_key:
20 os.environ["GOOGLE_API_KEY"] = google_key
21 else:
22 print("⚠️ 警告: 環境変数 'GEMINI_API_KEY' が設定されていません。")
23 print("実行前に 'export GEMINI_API_KEY=あなたのAPIキー' を実行してください。")
24 exit(1)
25
26def main():
27 """
28 Gemini TTSライブラリの機能をテストするメイン関数。
29
30 この関数は以下の操作を実行します:
31 1. Gemini TTSで利用可能な音声のリストを表示します。
32 2. 指定されたテキストと音声名 (`Puck`) を使用して、
33 指示 (`"明るく元気なトーンで"`) に基づき単一の音声ファイル
34 (`test_gemini_single.wav`) を生成します。
35 3. 音声ファイルの生成が成功した場合には、その旨をコンソールに表示します。
36
37 :returns: None: この関数は明示的に値を返しません。
38 """
39 print("=== Gemini TTS テスト開始 ===")
40
41 # 1. 利用可能な音声のリスト表示
42 tts.list_available_voices()
43
44 # 2. 単一テキストの音声合成テスト
45 outfile_single = "test_gemini_single.wav"
46 test_text = "こんにちは!Gemini 3.8 Flash TTSのテスト音声です。"
47 voice_name = "Puck"
48
49 print(f"\n🔊 単一音声の生成テスト: {voice_name} の声で生成します。")
50 result = tts.speak(
51 outfile=outfile_single,
52 text=test_text,
53 voice=voice_name,
54 instruction="明るく元気なトーンで"
55 )
56
57 if result:
58 print(f"✅ 成功: {result} を再生して確認してください。")
59
60if __name__ == "__main__":
61 main()