OpenClaw

volcengine-ai-audio-tts

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).

day2530 来源安装数☆ 0 仓库 Stars

查看来源 ↗安装与使用 SKILL.md ↗

安装与使用

请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求，再添加到工作流。

SkillHub CLI

skillhub install day253/day253-volcengine-ai-audio-tts

打开来源仓库，查看说明和兼容环境后，按来源提供的命令或步骤安装。

将来源链接提供给你的 Agent，让它先读取说明、核对依赖，并向你说明将执行的安装步骤。

查看来源 ↗使用指南

技能说明

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

Save generated audio files, request payloads, and response metadata to output/volcengine-ai-audio-tts/.
Keep one validation log per execution.

Prerequisites

Python 3.8+. No extra SDK required (uses requests and stdlib).
Install: pip install requests
Set environment variables (from Volcengine 豆包语音控制台):
- 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

text (string, required) — 合成文本，UTF-8，单次建议 ≤1024 字节
voice_type (string, required) — 音色，见发音人参数列表，如 BV700_streaming
encoding (string, optional) — 编码格式：pcm | wav | mp3 | ogg_opus，默认 mp3
rate (int, optional) — 采样率 8000/16000/24000，默认 24000
speed_ratio (float, optional) — 语速 [0.2, 3]，默认 1.0
volume_ratio (float, optional) — 音量 [0.1, 3]，默认 1.0
pitch_ratio (float, optional) — 音高 [0.1, 3]，默认 1.0
language (string, optional) — 语言，如 cn

Response

audio_path (string) — 本地保存的音频文件路径
sample_rate (int)
format (string)
duration_ms (string, when returned by API)
code (int) — 3000 表示成功

Quick start (Python script)

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

来源信息

Source: github
Repository: openclaw/skills
Path: skills/day253/day253-volcengine-ai-audio-tts
Version: —
Commit: dc72894d786e7824da85ed88012fd60fcd826332
分类来源: rules
状态: active
可见性: public

这些信息来自收录时的来源分析，可能滞后；使用前请核对最新来源文件。

来源内容

SKILL.md

Category: provider

# Volcengine 语音合成 TTS

## Validation

```bash
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

- Save generated audio files, request payloads, and response metadata to `output/volcengine-ai-audio-tts/`.
- Keep one validation log per execution.

## Prerequisites

- Python 3.8+. No extra SDK required (uses `requests` and stdlib).
- Install: `pip install requests`
- Set environment variables (from Volcengine 豆包语音控制台):
  - `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
- `text` (string, required) — 合成文本，UTF-8，单次建议 ≤1024 字节
- `voice_type` (string, required) — 音色，见 [发音人参数列表](https://www.volcengine.com/docs/6561/79824)，如 `BV700_streaming`
- `encoding` (string, optional) — 编码格式：`pcm` | `wav` | `mp3` | `ogg_opus`，默认 `mp3`
- `rate` (int, optional) — 采样率 8000/16000/24000，默认 24000
- `speed_ratio` (float, optional) — 语速 [0.2, 3]，默认 1.0
- `volume_ratio` (float, optional) — 音量 [0.1, 3]，默认 1.0
- `pitch_ratio` (float, optional) — 音高 [0.1, 3]，默认 1.0
- `language` (string, optional) — 语言，如 `cn`

### Response
- `audio_path` (string) — 本地保存的音频文件路径
- `sample_rate` (int)
- `format` (string)
- `duration_ms` (string, when returned by API)
- `code` (int) — 3000 表示成功

## Quick start (Python script)

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

搜索