Skip to main content

语音合成接口

版本要求： 标准版 及以上

介绍​

语音合成接口，可将文本内容合称为语音文件，支持多种音色可供选择，覆盖了通用问答、智能助手、有声阅读、视频配音、各地方言等多个场景。

在线接口调试：API接口调试

接口定义​

接口地址​

POST https://api.link-ai.tech/v1/audio/speech

请求头​

参数取值说明
AuthorizationBearer YOUR_API_KEY参考 接口鉴权说明 创建 API Key 并填入
Content-Typemultipart/form-data表明使用form表单格式上传语音文件

请求体​

参数类型是否必传说明
inputstring是需要合成为语音的文本内容
app_codestring否应用code，如果填写了该值，则使用应用中设置的音色
voicestring否音色编码，所有可选声音见 音色列表

注意： app_code 和 voice 参数至少有一个不为空，如果填写了 app_code 则使用应用中设置的音色，无需填写voice参数；如果填写了 voice 参数则直接使用指定的音色，无需再设置app_code参数。

在 "应用 - 模型设置 - 声音" 中可配置应用绑定的音色：


响应结果​

响应以二进制流的形式进行输出，可将响应结果保存为文件后进行播放。

错误说明​

当接口异常时会返回以下结构：

{
    "success": false,
    "code": 408,
    "message": "当前版本无该API访问权限",
    "data": null
}

根据 HTTP状态码 (status code) 和错误信息 判断错误类型：

HTTP状态码描述
400请求格式错误
401接口鉴权失败，请检查 API Key 是否填写正确
402应用不存在，请检查 app_code 参数是否正确
403无访问权限，对于未公开应用，只有创建者账号才能调用
406账号积分额度不足
408无API访问权限，该API支持标准版及以上版本调用
409内容审核不通过，问题、回答、检索的知识库中可能存在敏感词
503接口调用异常，联系客服处理

示例代码​

1.CURL请求​

curl https://api.link-ai.tech/v1/audio/speech \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "你好，请问有什么需要帮助的?",
    "voice": "BV700_V2_streaming"
  }' \
  --output speech.mp3

注意：在 YOUR_API_KEY 处填入你创建的 API Key，在file参数中填入音频文件的本地路径。

2.Python代码请求​

import requests
url = 'https://api.link-ai.tech/v1/audio/speech'
headers = {
    'Authorization': f'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}
data = {
    'input': '你好，请问有什么需要帮助的?',
    'voice': 'BV007_streaming'
}
res = requests.post(url, headers=headers, json=data)
file_path = "speech.mp3"
if res.status_code == 200:
    with open(file_path, 'wb') as f:
        f.write(res.content)
    print(f"语音合成成功，语音文件：{file_path}")
else:
    error = res.json()
    print(f"请求异常, 错误码={error.get('code')}, 错误信息={error.get('message')}")

注意：在 YOUR_API_KEY 处填入你创建的 API Key，在 file_path 变量中填入音频文件的本地路径。

3.更多语言和在线调试​

其他编程语言的接入代码可以在 API调试页面 进行代码生成，同时支持在线进行接口调试。