概述 欢迎使用语音交互服务（Speech Interaction Service ，简称SIS）。 语音交互服务（Speech Interaction Service，简称SIS）是一种人机交互方式，用户通过实时访问和调用API获取语音交互结果。
公共响应参数 公共响应参数如表 公共响应参数所示。 表1 公共响应参数 参数名 说明 Content-Length 响应消息体的字节长度，单位为Byte。 Date 系统响应的时间。 Content-type 发送的实体的MIME类型，取值为application/json。 父主题
状态码 表1 状态码 状态码 说明 100 Continue 101 Switching Protocols 200 OK 201 Created 202 Accepted 203 Non-Authoritative Information 204 NO Content 205 Reset
配置Java环境 配置环境 在使用语音交互SDK时，需要准备的环境请参见表 开发环境。 目前Java SDK不支持在android中使用。 表1 开发环境 准备项 说明 操作系统 Windows系统，推荐Windows 7及以上版本。 JDK Java开发环境的基本配置。版本要求：
配置Python环境 前提条件 确保已安装Python3，目前Python SDK仅支持Python3。 确保已安装setuptools、requests。 操作步骤 下载SDK，通过pip-list命令查看安装包。若未安装，则执行以下命令： pip install setuptools
区域与可用区 什么是区域与可用区
实时语音识别接口 接口说明 Websocket握手请求 实时语音识别请求 实时语音识别响应
调用说明 SIS服务提供接口，包含REST（Representational State Transfer）API，支持您通过HTTPS请求调用，调用方法请参见如何调用REST API。 调用所需示例音频参见示例音频。 调用接口的时候，无需开通服务，可直接调用。
公共请求参数 公共请求参数如表 公共请求参数所示。 表1 公共请求参数 参数 是否必选 说明 示例 Content-type 是 发送的实体的MIME类型。 application/json Content-Length POST/PUT请求必填。 GET不能包含。 请求body长度
获取AK/SK 如果已生成过AK/SK，则可跳过此步骤，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 如下图所示，文件包含了租户名（User Name），AK（Access Key Id），SK（Secret Access Key）。 图1 credential.csv
支持哪些语言 一句话识别支持中文普通话，带方言口音的普通话和方言（四川话、粤语和上海话）。 父主题： 产品咨询类
获取Token之后，您就可以使用Token认证调用SIS服务API。 获取Token后，再调用SIS服务API接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”
如何调整并发 API接口支持并发调用。具体可咨询商务合作。 父主题： API使用类
如何调用REST API 构造请求 认证鉴权 返回结果
响应示例如下，例如，语音交互服务部署的区域为“ap-southeast-1”，响应消息体中查找“name”为“ap-southeast-1”，其中projects下的“id”即为项目ID。
获取账号ID 在调用接口的时候，部分URL中需要填入账号ID（domain-id），所以需要先在管理控制台上获取到账号ID。账号ID获取步骤如下： 注册并登录管理控制台。 在控制台中，鼠标移动至右上角的用户名处，在下拉列表中选择“我的凭证”。 在“我的凭证”页面的项目列表中查看账号
请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 GET：请求服务器返回指定资源。 PUT：请求服务器更新指定资源。 POST：请求服务器新增资源或执行特殊操作。 DELETE：请求服务器删除指定资源，如删除对象等。
在使用完毕后一定要记得断开与服务端连接。 父主题： 错误码类
SIS.0032报错 问题描述 为何调用一句话识别的api接口，返回错误码"SIS.0032"，错误信息为:"'audio_format' is invalid"？ 解决方案 确保设置的audio_format格式的值是合法，待识别的音频格式和audio_format参数格式要保证一致
请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。
