AgentSkillsCN

fish-tts

通过 Fish Audio API 实现文本转语音功能。当用户请求音频、语音、TTS,或希望将文本朗读出来时,可使用此功能。系统将返回音频文件的路径。

SKILL.md
--- frontmatter
name: fish-tts
description: Text-to-speech using Fish Audio API. Use when user requests audio, voice, TTS, or wants text read aloud. Returns audio file path.

Fish Audio TTS

Generate speech from text using Fish Audio's TTS API.

Quick Usage

bash
./scripts/tts.sh "要轉換的文字" [output.mp3]

Environment Variables

VariableRequiredDefaultDescription
FISH_API_KEY-Fish Audio API key
FISH_REFERENCE_ID0bb80f15ff69492ea36f67174250cdb1Voice model ID
FISH_MODELs1模型:s1 (推薦) 或 speech-1.6 (備用)

Examples

bash
# 基本用法(使用 s1 模型)
./scripts/tts.sh "你好,我是勞大"

# 指定輸出檔案
./scripts/tts.sh "今天天氣很好" weather.mp3

# 使用舊模型 speech-1.6
FISH_MODEL="speech-1.6" ./scripts/tts.sh "用舊模型說話"

# 使用不同的聲音
FISH_REFERENCE_ID="your-model-id" ./scripts/tts.sh "換個聲音"

Models

ModelDescription
s1最新模型(預設,推薦)
speech-1.6舊版模型(備用,某些聲音效果較好)

Output

成功時輸出檔案路徑到 stdout:

bash
OUTPUT=$(./scripts/tts.sh "測試")
echo "Audio saved to: $OUTPUT"

Limitations

  • 輸出格式為 MP3
  • 需要有效的 FISH_API_KEY