用途：openai-tts-tool 是调用 OpenAI 文本转语音（TTS）API 的命令行工具，用于把文本合成为音频，适合文档转音频、演示或视频配音、语音样本生成以及批量文本转音频。它处理完整文本，不适用于实时流式 TTS、声音克隆、语音识别或音频后期编辑。
主要能力：synthesize 命令将文本转为音频，可选语音（alloy、echo、fable、onyx、nova、shimmer，默认 alloy）、模型（tts-1 默认、tts-1-hd）、输出文件（默认 output.mp3，支持 .mp3、.wav、.ogg、.flac）和语速（默认 1.0，范围 0.25 至 4.0）。list-voices 与 list-models 列出可用语音和模型，支持 table 或 json 格式。info 显示 API 密钥状态、版本、输出格式与网络状态等配置。completion 为 bash、zsh、fish 生成补全脚本。工具还支持 -v 至 -vvv 的日志级别。
使用方式：需 Python 3.14+、OpenAI API 密钥（环境变量 OPENAI_API_KEY），推荐 mise 与 uv。安装：git clone https://github.com/dnvriend/openai-tts-tool.git；cd openai-tts-tool；mise use -g python@3.14；uv sync；uv tool install .。也可用 uv run openai-tts-tool --help 本地运行。基本用法：openai-tts-tool synthesize "Hello, world!"；openai-tts-tool info；openai-tts-tool list-voices。可通过 OPENAI_TTS_OUTPUT_DIR、OPENAI_TTS_VOICE、OPENAI_TTS_VERBOSE 等环境变量配置。
限制：需要有效的 OpenAI API 密钥和网络连接；不提供实时流式合成、声音克隆、语音识别或音频编辑；具体收费与价格资料未提供，需参考 OpenAI 官方定价。退出码 0 成功、1 客户端错误、2 服务端错误、3 网络错误、4 配置错误。