快速开始
创建 API Token 并生成第一段语音。
快速开始
本页帮助你快速完成一次真实的文字转语音请求。第一次测试建议先使用同步 TTS，因为它会直接返回音频，最容易验证。
1. 创建 API Token
在 FishSpeech 账户中创建 API Token：
完整 Token 只会展示一次。请把它存放在服务端环境变量中，不要放进浏览器代码、移动端应用或公开仓库。
export FISHSPEECH_API_TOKEN="YOUR_API_TOKEN"2. 选择音色
查询当前账户可用音色：
curl "https://fishaudio.org/api/open/v1/voices" \
-H "Authorization: Bearer $FISHSPEECH_API_TOKEN"复制返回的音色 id，并在后续请求中作为 voiceId 使用。
3. 生成语音
curl -X POST "https://fishaudio.org/api/open/v1/speech/tts" \
-H "Authorization: Bearer $FISHSPEECH_API_TOKEN" \
-H "Content-Type: application/json" \
-o speech.audio \
-d '{
"text": "Hello from FishSpeech.",
"voiceId": "YOUR_VOICE_ID",
"format": "mp3"
}'请求成功后，当前目录会生成 speech.audio。最终文件扩展名请以响应的 Content-Type 为准。
下一步
| 需要 | 阅读 |
|---|---|
| 选择同步、异步或多人脚本流程 | 接口选择 |
| 查看接口契约 | API Reference |
| 理解鉴权方式 | 认证 |
| 生成语音 | 文字转语音 |
| 在浏览器中测试请求 | API Playground |