OpenAI TTS

OpenAI TTS (curl)

Generate speech from text via OpenAI's /v1/audio/speech endpoint.

Quick start

{baseDir}/scripts/speak.sh "Hello, world!"
{baseDir}/scripts/speak.sh "Hello, world!" --out /tmp/hello.mp3

Defaults:

• -Model: tts-1 (fast) or tts-1-hd (quality)
• -Voice: alloy (neutral), also: echo, fable, onyx, nova, shimmer
• -Format: mp3

Voices

| Voice | Description |

|-------|-------------|

| alloy | Neutral, balanced |

| echo | Male, warm |

| fable | British, expressive |

| onyx | Deep, authoritative |

| nova | Female, friendly |

| shimmer | Female, soft |

Flags

{baseDir}/scripts/speak.sh "Text" --voice nova --model tts-1-hd --out speech.mp3
{baseDir}/scripts/speak.sh "Text" --format opus --speed 1.2

Options:

• ---voice <name>: alloy|echo|fable|onyx|nova|shimmer (default: alloy)
• ---model <name>: tts-1|tts-1-hd (default: tts-1)
• ---format <fmt>: mp3|opus|aac|flac|wav|pcm (default: mp3)
• ---speed <n>: 0.25-4.0 (default: 1.0)
• ---out <path>: output file (default: stdout or auto-named)

API key

Set OPENAI_API_KEY, or configure in ~/.clawdbot/clawdbot.json:

{
  skills: {
    entries: {
      "openai-tts": {
        apiKey: "sk-..."
      }
    }
  }
}

Pricing

• -tts-1: ~$0.015 per 1K characters
• -tts-1-hd: ~$0.030 per 1K characters

Very affordable for short responses!