mcpField
O
openai-tts

openai-tts

github.com/sundial-orgCreative & media67072 installsUpdated 34w ago
Repository

About openai-tts

A command-line skill that turns text into speech through OpenAI's audio speech endpoint, with options for voice, model, format, and speed.

Key features

  1. 01Text-to-speech via OpenAI endpoint
  2. 02Six selectable voices
  3. 03Two model options
  4. 04Configurable output format and speed

Use cases

  1. 01Generate spoken versions of short text
  2. 02Save generated speech as an audio file

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sundial-org/awesome-openclaw-skills --skill openai-tts

After installing, type/openai-ttsin Claude Code to confirm it loaded.

Bundled filesscripts/speak.sh

Details

From the project README

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

VoiceDescription
alloyNeutral, balanced
echoMale, warm
fableBritish, expressive
onyxDeep, authoritative
novaFemale, friendly
shimmerFemale, 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!

Comments

Markdown supported