> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# バッチ Text-to-Speech

> Cartesia SDKを使用してテキストからWAVファイルを生成します。

テキストから音声を生成し、WAVファイルとして保存します。

## 前提条件

このチュートリアルでは、シェル環境にCartesia APIキーが必要です。[https://play.cartesia.ai/keys](https://play.cartesia.ai/keys) でAPIキーを取得し、次のコマンドを実行するか、`.bashrc` または `.zshrc` に追加してください:

```sh theme={null}
export CARTESIA_API_KEY=<your api key here>
```

## WAVファイルを生成する

<Tabs>
  <Tab title="Python">
    <Steps>
      <Step title="SDKをインストールする">
        ```sh theme={null}
        pip install cartesia
        ```
      </Step>

      <Step title="音声を生成する">
        ```python generate_speech.py theme={null}
        from cartesia import Cartesia
        import os
        import sys

        client = Cartesia(api_key=os.getenv("CARTESIA_API_KEY"))

        response = client.tts.generate(
            model_id="sonic-3.5",
            transcript="Hello, world! Welcome to Cartesia.",
            voice={"mode": "id", "id": "694f9389-aac1-45b6-b726-9d9369183238"},
            output_format={"container": "wav", "encoding": "pcm_f32le", "sample_rate": 44100},
        )
        sys.stdout.buffer.write(response.content)
        ```
      </Step>

      <Step title="実行する">
        ```sh theme={null}
        python3 generate_speech.py | ffplay -nodisp -autoexit -loglevel quiet -
        # Or save to a file:
        python3 generate_speech.py > output.wav
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="JavaScript">
    <Steps>
      <Step title="SDKをインストールする">
        ```sh theme={null}
        npm install @cartesia/cartesia-js
        ```
      </Step>

      <Step title="音声を生成する">
        ```js generate_speech.mjs theme={null}
        import Cartesia from "@cartesia/cartesia-js";

        const client = new Cartesia({ apiKey: process.env["CARTESIA_API_KEY"] });

        const response = await client.tts.generate({
          model_id: "sonic-3.5",
          transcript: "Hello, world! Welcome to Cartesia.",
          voice: { mode: "id", id: "694f9389-aac1-45b6-b726-9d9369183238" },
          output_format: { container: "wav", encoding: "pcm_f32le", sample_rate: 44100 },
        });

        process.stdout.write(Buffer.from(await response.arrayBuffer()));
        ```
      </Step>

      <Step title="実行する">
        ```sh theme={null}
        node generate_speech.mjs | ffplay -nodisp -autoexit -loglevel quiet -
        # Or save to a file:
        node generate_speech.mjs > output.wav
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="cURL">
    <Steps>
      <Step title="音声を生成する">
        ```bash generate_speech.sh theme={null}
        #!/usr/bin/env bash
        curl -X POST "https://api.cartesia.ai/tts/bytes" \
          -H "Cartesia-Version: 2025-04-16" \
          -H "X-API-Key: $CARTESIA_API_KEY" \
          -H "Content-Type: application/json" \
          -d '{
            "model_id": "sonic-3.5",
            "transcript": "Hello, world! Welcome to Cartesia.",
            "voice": {"mode": "id", "id": "694f9389-aac1-45b6-b726-9d9369183238"},
            "output_format": {"container": "wav", "encoding": "pcm_s16le", "sample_rate": 44100}
          }'
        ```
      </Step>

      <Step title="実行する">
        ```sh theme={null}
        bash generate_speech.sh | ffplay -nodisp -autoexit -loglevel quiet -
        # Or save to a file:
        bash generate_speech.sh > output.wav
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

上記で使用されているボイスは、[プレイグラウンドで確認できます](https://play.cartesia.ai/voices/694f9389-aac1-45b6-b726-9d9369183238)。その他のボイスは [play.cartesia.ai/voices](https://play.cartesia.ai/voices) で閲覧できます。

## 次のステップ

<CardGroup cols={3}>
  <Card title="Text-to-Speech クイックスタート" icon="comment-dots" href="/get-started/realtime-text-to-speech-quickstart">
    WebSocketストリーミングを使用してLLMの出力をリアルタイムでTTSにパイプします。
  </Card>

  <Card title="ボイスを選ぶ" icon="microphone" href="/build-with-cartesia/capability-guides/choosing-a-voice">
    ボイスを閲覧し、ユースケースに合った適切なボイスの選び方を学びます。
  </Card>

  <Card title="TTS 出力オーディオフォーマット" icon="sliders" href="/build-with-cartesia/capability-guides/tts-output-audio-format">
    ユースケースに合った出力フォーマット、サンプルレート、エンコーディングを選びます。
  </Card>
</CardGroup>