
# 调用API实现一句话识别
本章节提供了通过Postman调用一句话识别API的样例，详细介绍如何调用一句话识别API接口，帮助您快速熟悉语音交互服务的使用方法。调用SIS服务的具体操作如下：
[步骤1：配置环境]
[步骤2：Token认证]
[步骤3：调用一句话识别]
#### 准备工作
注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。
#### 操作须知
语音交互服务的API接口已全部商用，无需开通，可直接调用。调用费用请参见[语音交互价格计算器](https://www.huaweicloud.com/pricing.html#/sis)。
 #### 步骤1：配置环境
1. 下载并安装Postman，Postman建议使用7.24.0版本。
2. 下载华为云SIS服务Postman的配置文件。 配置文件下载地址：[sis-postman.json](https://sis-sdk-repository.obs.cn-north-1.myhuaweicloud.com/postman/sis-postman.json)。
   如果浏览器显示文件内容，鼠标右键另存为JSON文件。
   
3. 导入配置文件。
   1. 打开并登录Postman。
   
   2. 单击左上角"File \> Import \> Import File \> Choose Files"导入配置文件。
      图1导入配置文件   
      ![](https://support.huaweicloud.com/qs-sis/zh-cn_image_0000001154367232.png)
      配置文件导入成功后，将显示在Postman左侧导航栏中。
      ![](https://support.huaweicloud.com/qs-sis/zh-cn_image_0000001165847893.png)
      
      
    
 
 #### 步骤2：Token认证
Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。
1. 在Postman界面上，单击左侧导航树"获取token"配置文件。
2. 选中"Body"的配置项，添加华为云用户名、密码、账号名。可在[我的凭证](https://console.huaweicloud.com/iam/#/myCredential)获取这些信息。
   - username：IAM用户名。
   
   - password：IAM用户密码。
   
   - domainname：账号名。
   
   - project name：表示服务部署区域名，如在本示例中服务部署区域为cn-north-4，详细介绍请参见[终端节点](https://support.huaweicloud.com/api-sis/sis_03_0004.html)。
     ![](https://support.huaweicloud.com/qs-sis/public_sys-resources/note_3.0-zh-cn.png)
     获取Token时，如果出现账密报错The username or password is wrong，请参见[常见问题](https://support.huaweicloud.com/sis_faq/sis_04_0011.html)解决。
     图2Token认证鉴权   
     ![](https://support.huaweicloud.com/qs-sis/zh-cn_image_0000001154366234.png) 
    
3. 单击"Send"，发送请求，获取并复制Token。 获取返回结果"Headers"中的"X-Subject-Token"即为Token。Token有效期为24小时。
   图3获取Token   
   ![](https://support.huaweicloud.com/qs-sis/zh-cn_image_0000001200247009.png) 
 
 #### 步骤3：调用一句话识别
1. 在Postman界面上，单击左侧导航树"一句话识别"。
2. 单击"Headers"，复制获取的Token，替换"X-Auth-Token"中的值。
3. 使用项目ID替换"{{cn4-project_id}}"值。可在[我的凭证](https://console.huaweicloud.com/iam/#/myCredential)获取项目ID。
4. 单击"body"，复制音频的base64编码值到data参数中（配置文件中已填充示例音频）。
5. 单击"send"，发送请求，查看识别结果。 ![](https://support.huaweicloud.com/qs-sis/zh-cn_image_0000001119048206.png)
   
   
 
