Volcengine 语音合成 TTS

---

name: volcengine-ai-audio-tts

description: Text-to-speech generation on Volcengine (ByteDance) speech services. Use when users need narration, multi-language speech output, voice selection, or TTS troubleshooting. Supports online one-shot HTTP API (openspeech.bytedance.com).

---

Category: provider

# Volcengine 语音合成 TTS

Validation

mkdir -p output/volcengine-ai-audio-tts
python -m py_compile skills/ai/audio/volcengine-ai-audio-tts/scripts/generate_tts.py && echo "py_compile_ok" > output/volcengine-ai-audio-tts/validate.txt

Pass criteria: command exits 0 and `output/volcengine-ai-audio-tts/validate.txt` is generated.

Output And Evidence

Prerequisites

- `VOLCENGINE_TTS_APP_ID` — 应用 ID

- `VOLCENGINE_TTS_TOKEN` — 应用 Token（用于 Authorization: Bearer;${token}）

- `VOLCENGINE_TTS_CLUSTER` — 业务集群，如 `volcano_tts`（标准音色）

Optional: use `.env` in repo root or script directory; script will load them.

Normalized interface (tts.generate)

Request

Response

Quick start (Python script)

# 使用内联 JSON 请求
python skills/ai/audio/volcengine-ai-audio-tts/scripts/generate_tts.py \
  --request '{"text":"你好，这是一段测试语音。","voice_type":"BV700_streaming"}' \
  --output output/volcengine-ai-audio-tts/audio/out.mp3

# 使用请求文件
python skills/ai/audio/volcengine-ai-audio-tts/scripts/generate_tts.py \
  --file request.json \
  --output output/volcengine-ai-audio-tts/audio/out.wav \
  --print-response

Operational guidance

Output location

Workflow

1) Confirm user intent, text, voice, and output format.

2) Run one minimal request to verify credentials and cluster/voice_type.

3) Execute the target synthesis with explicit parameters.

4) Verify results and save output/evidence files.

References