fish-tts

Category: Content & Multimedia | Uploader: tzcnbo | Downloads: 0 | Version: v1.0（Latest）

使用 Fish Audio 将文本转换为语音，返回 MP3 音频文件。支持指定音色模型、语速、音量等参数。

Changelog: Source: GitHub https://github.com/tzcnbo/fish-tts-api

Directory Structure

Current level: openclaw-skill/

📄 SKILL.md 2.3 KB

SKILL.md

---
name: fish-tts
description: 使用 Fish Audio 将文本转换为语音，返回 MP3 音频文件。支持指定音色模型、语速、音量等参数。
triggers:
  - tts
  - 语音合成
  - 文字转语音
  - text to speech
  - 朗读
  - 生成语音
  - 读出来
tools:
  - exec
  - file
---

# Fish TTS Skill

通过 Fish Audio TTS API 将文本转换为语音音频文件。

## 环境要求

- Fish TTS API 服务已部署并可访问
- 服务地址配置在环境变量 `FISH_TTS_API_URL` 中（默认 `http://localhost:8900`）

## 使用场景

- 用户要求将一段文字转为语音
- 用户要求朗读某段内容
- 用户需要生成语音文件

## 工作流程

1. 确认用户要转换的文本内容
2. 调用 Fish TTS API 生成音频
3. 将音频保存为文件并告知用户文件路径

## 具体步骤

### 步骤 1：提取参数

从用户消息中提取以下参数：
- `text`（必填）：要转换的文本
- `model_id`（可选）：音色模型 ID，不指定则使用服务端默认音色
- `speed`（可选）：语速，范围 0.5-2.0，默认 1.0
- `volume`（可选）：音量，范围 -10 到 10，默认 0

### 步骤 2：调用 API

使用以下 curl 命令调用 API：

```bash
curl -s -X POST "${FISH_TTS_API_URL:-http://localhost:8900}/api/tts" \
  -H "Content-Type: application/json" \
  -d '{"text": "用户的文本", "speed": 1.0}' \
  -o /tmp/tts_output.mp3
```

如果用户指定了 model_id，加入请求体：
```bash
curl -s -X POST "${FISH_TTS_API_URL:-http://localhost:8900}/api/tts" \
  -H "Content-Type: application/json" \
  -d '{"text": "用户的文本", "model_id": "xxx", "speed": 1.0}' \
  -o /tmp/tts_output.mp3
```

### 步骤 3：验证结果

- 检查文件大小是否大于 0
- 如果文件为空或 curl 返回非 0，向用户报告错误
- 成功时告知用户文件保存路径

### 步骤 4：发送文件

将生成的音频文件路径告知用户，或通过当前通信渠道发送文件。

## 查询服务状态

如果用户询问 TTS 服务状态或账号余额：

```bash
curl -s "${FISH_TTS_API_URL:-http://localhost:8900}/api/accounts"
```

## 注意事项

- 文本长度不要超过 5000 字
- 输出文件默认保存到 `/tmp/tts_output.mp3`
- 如果用户指定了输出路径，使用用户指定的路径
- 如果 API 返回错误，展示错误信息帮助用户排查

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

fish-tts

Directory Structure

SKILL.md

Report

Notice