根据服务类型、接入地域和网络环境选择智能语音交互的服务地址,并配置与接入地址匹配的访问凭证。
选择接入点
域名标识服务入口,完整请求 URL 还包含协议和接口路径。调用时应使用对应服务的完整 URL,不能只替换域名而忽略接口路径和鉴权方式。
使用新加坡接入点调用服务。客户端需要能够访问该接入点,并使用对应的 Appkey 和 Token。
公网访问:适用于本地服务器、其他云服务器及具有公网出站连接的 ECS 实例。调用 NLS 不需要专门配置公网入站地址,但运行环境仍需具备可用的出站网络,并允许所需协议和端口。
服务接入地址
一句话识别、实时语音识别和短文本语音合成
WebSocket 接口使用 /ws/v1 路径。不同服务的消息命名空间和参数不同,即使 URL 相同,也不能混用调用协议。
|
网络 |
地域 |
WebSocket URL |
|
公网 |
新加坡 |
|
一句话识别和短文本语音合成还支持 RESTful API。下表列出完整 URL;实时语音识别不使用这两个 RESTful 路径。
|
服务 |
地域 |
RESTful URL |
|
一句话识别 |
新加坡 |
|
|
短文本语音合成 |
|
鉴权与地域配置
Token 签发服务与语音网关是不同的地址。调用使用 Token 鉴权的语音接口前,先获取 Token;获取方法请参见通过 SDK 获取 Token。
通过 nlsmeta.ap-southeast-1.aliyuncs.com 获取 Token,并使用 nls-gateway-ap-southeast-1.aliyuncs.com 调用语音服务。Token 请求的地域为 ap-southeast-1。
Token 的有效期以获取接口返回的 ExpireTime 为准。地域和域名配置正确不代表已开通全部服务,调用前仍需确认相应服务已开通。