Bambuk 四类模型 API
语音合成 TTS
发送文本与语言参数，获取音频二进制。
POST /api/v1/ai/bambuk/tts
请求参数
使用 multipart/form-data。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| target_text | string | 是 | 要合成的文本 |
| language | string | 建议提供 | 文本语言代码，例如 zh、ug |
| voice | string | 否 | 音色标识；示例为 female，实际以部署模型为准 |
| speed | number | 否 | 语速；示例为 1.0，支持范围由模型决定 |
| ref_audio | binary | 否 | 模型支持参考音频时使用 |
| ref_text | string | 否 | 与参考音频对应的文本 |
参考音频功能和音色不能仅凭参数存在就视为已开放，先确认对应模型版本、格式和授权要求。
调用示例
成功调用将直接返回音频二进制数据，可通过输出重定向或写入文件直接保存。
curl --fail-with-body --max-time 300 "$BAMBUK_BASE_URL/ai/bambuk/tts" \
-H "AppKey: $BAMBUK_APP_KEY" \
-H "Content-Type: application/json" \
-d '{"target_text":"你好，欢迎使用 Bambuk。","language":"zh","voice":"female"}' \
--output speech.wav响应处理
成功时返回音频二进制，不能调用 response.json()。使用响应 Content-Type 判断音频类型，保存文件时采用匹配的扩展名。
失败时可能返回 JSON 错误。程序应先检查 HTTP 状态和 Content-Type，再将内容保存为音频，避免把错误信息当作声音文件。