服务开通、关闭说明 使用SIS服务，无需显性执行开通操作， 注册华为账号 并开通华为云后，账户未欠费，即可调用SIS服务，调用成功后即认为已开通调用接口。此时计费方式为按需计费，不使用不计费。若用户从未调用过SIS服务接口，账户欠费则会被拦截，无法调用。 您也可以在控制台购买套餐包，套餐包费用为一次性支付，支付成功后即刻生效或自定义指定时间生效。套餐包到期、套餐额度使用完，会自动转为按需计费。 服务详细计费规格请参见价格计算器。

创建终端节点 用户登录华为云控制台，单击左上角，输入VPCEP，进入 VPC终端节点 服务。 图1 服务列表 进入终端节点服务，点击“购买终端节点”。 图2 购买终端节点 选择和填写终端节点相关配置并提交购买。 区域：选择和SIS业务相同的region。例如SIS业务在华北-北京四，则区域也选择华北北京四。 服务类别：选择“按名称查找服务”。 服务名称：根据region，按照以下表填写，当前SIS服务支持上海一、北京四、新加坡区域。 表1 SIS服务各区域 APIG 终端节点服务名称 区域 Region ID 终端节点服务名称 北京四 cn-north-4 cn-north-4.apig-sis.1e71d41d-5799-422c-8481-464e05e3ca4e 上海一 cn-east-3 cn-east-3.apig-sis.77a40357-e621-409c-8c43-52ad02aef2be 新加坡 ap-southeast-3 ap-southeast-3.apig-sis.e842ef88-b560-4f82-aa94-0556845d79b4 图3 配置终端节点购买信息 单击“立即购买”，完成终端节点（VPCEP）购买。 完成购买后，终端节点新增一条节点记录，需要记录“服务地址”列的IP值。 注意：新申请的终端节点记录“状态”为“待接受”。需要等待SIS服务后端接受连接后（连接申请请参考申请“终端节点连接SIS服务端”），即终端节点记录状态变为“已接受”后，再记录“服务地址”列的IP值。 图4 记录服务地址 父主题： 华为云租户区内网调用SIS服务方案

连通性测试 验证需要一台测试机器，要求和现网SIS业务部署节点相同vpc，同时不运行任何业务，避免测试影响实际业务。 配置host，将标准 域名 映射至vpcep的ip地址。执行 vim /etc/hosts 命令，新增一行sis服务标准域名映射。 其中左列的ip地址要修改成在新建vpcep中记录的ip地址，右列的域名替换成sis标准域名，取值如下表所示 表1 SIS服务标准域名 区域 Region ID 终端节点服务名称 北京四 cn-north-4 cn-north-4.apig-sis.1e71d41d-5799-422c-8481-464e05e3ca4e 上海一 cn-east-3 cn-east-3.apig-sis.77a40357-e621-409c-8c43-52ad02aef2be 新加坡 ap-southeast-3 ap-southeast-3.apig-sis.e842ef88-b560-4f82-aa94-0556845d79b4 执行 ping 标准域名 命令，能显示vpcep的ip地址。 使用标准域名测试业务用到的接口，能正常返回结果，则说明该终端节点可用。如果返回是APIG的报错或者是连接报错，则停止操作，提工单给SIS服务，排查问题。 如 语音合成 接口可以用curl命令测试 curl -k -X POST -H 'Content-Type:application/json' -H 'X-Auth-Token:${token}' -d '{"text": "123", "config": {"audio_format": "wav", "sample_rate": "16000", "property": "chinese_huaxiaolong_common"}}' https://${标准域名}/v1/${project_id}/tts 其中${token}替换成真实token， ${标准域名}替换成表1中SIS服务标准域名， ${project_id}替换成真实的projectId。 父主题： 华为云租户区内网调用SIS服务方案

白名单添加 1. 通过工单方式（https://console.huaweicloud.com/ticket/?region=cn-east-3#/ticketindex/feedbackBusiness），提单给SIS，说明开通SIS服务VPCEP白名单的需求，同时提供DomainId，domainId获取可参考：https://support.huaweicloud.com/api-sis/sis_03_0050.html 2. 待云服务添加白名单，并明确在工单回复后。可进行进行下一步操作。

创建内网DNS 进入dns console（https://console.huaweicloud.com/dns）。 点击“内网域名”页签，点击“创建内网域名” 3. 创建内网域名具体参数如下： 域名：按照表3 填写，具体填写com域名还是cn域名根据您的实际使用情况而定。如果您使用sdk，则默认使用com域名。 子域名递归解析代理：一定要勾选，否则在添加解析前会断服！ 区域：需要和实际业务部署区域保持一致。 VPC：实际业务部署使用VPC 企业项目：根据实际需求填写。 表3 sis服务域名 region 域名 北京四 cn-north-4.myhuaweicloud.com cn-north-4.myhuaweicloud.cn 上海一 cn-east-3.myhuaweicloud.com cn-east-3.myhuaweicloud.cn 4. 点击创建内网域名，点击“添加记录集”。具体参数如下： 主机记录：sis-ext 记录类型：选择“A-将域名指向IPv4地址” TTL：选择默认5分钟即可 记录值：填写vpcep的IP地址 5. 使用标准域名访问测试，能正常返回结果 如语音合成接口可以用curl命令测试 curl -k -X POST -H 'Content-Type:application/json' -H 'X-Auth-Token:${token}' -d '{"text": "123", "config": {"audio_format": "wav", "sample_rate": "16000", "property": "chinese_huaxiaolong_common"}}' https://${标准域名}/v1/${project_id}/tts 其中${token}替换成真实token， ${标准域名}替换成表2， ${project_id}替换成真实的projectId。 如果返回异常，则删除内网dns解析，同时提工单给SIS云服务，排查问题。

验证终端节点 1. 验证需要一台测试机器，要求和现网业务部署节点相同vpc，同时不运行任何业务，避免测试影响实际业务。 2. 配置host，将标准域名映射至vpcep的ip地址。执行 vim /etc/hosts 命令，新增一行sis服务标准域名映射。 其中左列的ip地址要修改成在新建vpcep中记录的ip地址，右列的域名替换成sis标准域名，取值如下表所示 表2 sis服务标准域名 region 标准域名 上海一 sis-ext.cn-north-4.myhuaweicloud.com 北京四 sis-ext.cn-east-3.myhuaweicloud.com 3. 执行 ping 标准域名 命令，能显示vpcep的ip地址。 4. 使用标准域名测试业务用到的接口，能正常返回结果，则说明该终端节点可用。如果返回是APIG的报错或者是连接报错，则停止操作。提工单给SIS服务，排查问题。 如语音合成接口可以用curl命令测试 curl -k -X POST -H 'Content-Type:application/json' -H 'X-Auth-Token:${token}' -d '{"text": "123", "config": {"audio_format": "wav", "sample_rate": "16000", "property": "chinese_huaxiaolong_common"}}' https://${标准域名}/v1/${project_id}/tts 其中${token}替换成真实token， ${标准域名}替换成表2， ${project_id}替换成真实的projectId。 5. 验证通过后要删除新增host行，此步骤一定要完成，否则影响下一步验证。

新建vpcep 进入终端节点页面（https://console.huaweicloud.com/vpc） 点击“购买终端节点”。 3. 具体选择参数说明如下： 区域：选择和部署业务相同的region。例如业务部署在华北-北京四，则区域也选择华北北京四。 服务类别：选择“按名称查找服务” 服务名称：根据region，按照表1填写。当前sis服务仅支上海一和北京四两个region 虚拟私有云：选择和业务相同vpc。例如业务部署在vpc-default下，则虚拟私有云也选择vpc-default。如果不在同一vpc，则终端节点业务不可用。 访问控制：默认关闭。可根据实际业务决定。 表1 服务名称 区域 服务名称 华北-北京四 华东-上海一 4. 提交后属于待接受状态，需要工单通知SIS云服务，等待云服务变更，接受连接。 5. 云服务会在提交后的一周内完成接受，接受后状态切换至已接受。同时记录服务地址。此地址为vpcep的ip地址。

方案介绍 本方案适用于华为云内网用户，此处的内网用户指的是在华为云购买E CS 主机或资源，但未绑定公网弹性IP（EIP）的用户。 本方案可以不经过公网也可访问SIS服务，但需要经过内网DNS解析到终端节点（VPCEP），连接APIG所提供的终端节点服务（VPCEP Service），最终调用SIS服务接口，为下图红色箭头所指路径。下图所示红色框内“内网DNS”和“终端节点”两个服务组件需要内网客户配合进行相关配置后，方可使用内网路径进行SIS服务接口调用。 公网用户通过请求SIS服务公网域名，经公网DNS服务解析至APIG服务，最终调用SIS服务接口，为下图中蓝色箭头所示路径。 图1 服务调用说明 父主题： 华为云租户区内网调用SIS服务方案

初始化Client 初始化RttsClient，其参数包括AuthInfo 表1 AuthInfo 参数名称 是否必选 参数类型 描述 ak 是 String 用户的ak，可参考AK/SK认证。 sk 是 String 用户的sk，可参考AK/SK认证。 projectId 是 String 项目ID，同region一一对应，参考获取项目ID。 region 是 String 区域，如cn-north-4，参考终端节点。 endpoint 否 String 终端节点，参考地区和终端节点。一般使用默认即可。

请求参数 请求类为RttsRequest，详见表 RttsRequest。 表2 RttsRequest 参数名称 是否必选 参数类型 描述 text 是 String 待合成文本，不超过500字。 通过set方法可以设置具体参数，详见表 RttsRequest设置参数 表3 RttsRequest设置参数 方法名称 是否必选 参数类型 描述 SetAudioFormat 否 String 设置语音格式，默认pcm。 SetAudioProperty 否 String 设置语音合成特征字符串，{language}_{speaker}_{domain}，即“语种_人员标识_领域”。默认chinese_xiaoyan_common 。详见API文档。 SetSampleRate 否 String 设置采样率：8000、16000，默认8000。 SetPitch 否 Integer 设置音高，-500~500，默认0。 SetVolume 否 Integer 设置音量，0~100，默认50。 SetSpeed 否 Integer 设置语速，-500~500，默认0。

初始化Client 初始化HotWordClient，其参数包括AuthInfo和SisConfig。 表1 AuthInfo 参数名称 是否必选 参数类型 描述 ak 是 String 用户的ak，可参考AK/SK认证。 sk 是 String 用户的sk，可参考AK/SK认证。 region 是 String 区域，如cn-north-4，参考终端节点。 projectId 是 String 项目ID，同region一一对应，参考获取项目ID。 endpoint 否 String 终端节点，参考地区和终端节点。 表2 SisConfig 参数名称 是否必选 参数类型 描述 connectionTimeout 否 Integer 连接超时，默认10000，单位ms。 readTimeout 否 Integer 读取超时，默认10000，单位ms。

请求参数 请求类为HotWordRequest，详见表3。 表3 HotWordRequest 参数名称 是否必选 参数类型 描述 name 是 String 热词表名，创建时不可重复。内容限制为字母，数字，下中划线和井号，长度不超过32字节。 language 是 String 热词表语言类型，目前支持汉语普通话“chinese_mandarin”。 contents 是 Array of String 热词库，单词库支持热词数上限10000。中文单个热词长度上限32字节。 description 否 String 热词表描述，长度不超过255字节。

初始化Client 初始化SisClient,详细信息如下。 配置客户端连接参数。 默认配置 // 使用默认配置 HttpConfig config = HttpConfig.getDefaultHttpConfig(); 网络代理（可选） // 根据需要配置网络代理，网络代理默认的协议为 `http` 协议 config.withProxyHost("proxy.huaweicloud.com") .withProxyPort(8080) .withProxyUsername("test") .withProxyPassword("test"); 超时配置（可选） // 默认连接超时时间为60秒，可根据需要调整 config.withTimeout(60); SSL配置（可选） // 根据需要配置是否跳过SSL证书验证 config.withIgnoreSSLVerification(true); 配置认证信息。 配置AK、SK、project_id信息。华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。 使用永久AK和SK BasicCredentials basicCredentials = new BasicCredentials() .withAk(ak) .withSk(sk) .withProjectId(projectId); 使用临时AK和SK BasicCredentials basicCredentials = new BasicCredentials() .withAk(ak) .withSk(sk) .withSecurityToken(securityToken) .withProjectId(projectId) 认证参数说明： ak、sk：访问密钥信息，获取方法请参考AK/SK认证。 projectId：华为云项目ID，获取方法请参考获取项目ID。 securityToken：采用临时AK、SK 认证场景下的安全票据，可以通过token获取或者通过委托授权获取。 初始化客户端（region和指定云服务enddpoint二选一即可）。 指定region方式（强烈推荐推荐） // 初始化客户端认证信息，使用当前客户端初始化方式可不填 projectId/domainId，以初始化 BasicCredentials 为例 BasicCredentials basicCredentials = new BasicCredentials() .withAk(ak) .withSk(sk); // 初始化指定云服务的客户端 {Service}Client ，以初始化 Region 级服务Sis的 SisClient 为例 SisClient client = SisClient.newBuilder() .withHttpConfig(config) .withCredential(bhttps://developer.huaweicloud.com/endpoint?SISasicCredentials) .withRegion(SisRegion.valueOf("cn-north-4")) .build(); 指定云服务endpoint方式（可选） // 指定终端节点，以Sis服务北京四的 endpoint 为例 String endpoint = "https://sis-ext.cn-north-4.myhuaweicloud.com"; // 初始化客户端认证信息，需要填写相应 projectId/domainId，以初始化 BasicCredentials 为例 BasicCredentials basicCredentials = new BasicCredentials() .withAk(ak) .withSk(sk) .withProjectId(projectId); // 初始化指定云服务的客户端 {Service}Client ，以初始化 Region 级服务SiS的 SisClient 为例 SisClient client = SisClient.newBuilder() .withHttpConfig(config) .withCredential(basicCredentials) .withEndpoint(endpoint) .build(); endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点。

请求参数 请求类为RecognizeShortAudioRequest，该类的body参数为PostShortAudioReq。 PostShortAudioReq的包含data,和config两个参数，其中data为识别音频的base64格式的字符串。Config参数详见表1。 表1 Config 参数 是否必选 参数类型 描述 audioFormat 是 String 支持语音的格式，请参考表 audio_format取值范围。 property 是 String 所使用的模型特征串，通常是 “语种_采样率_领域”的形式，采样率需要与音频采样率保持一致，取值范围请参考表 property取值范围。 addPunc 否 String 表示是否在识别结果中添加标点，取值为“yes”和“no”，默认为“no”。 digitNorm 否 String 表示是否将语音中的数字识别为阿拉伯数字，取值为“yes” 和 “no”，默认为“yes”。 vocabularyId 否 String 热词表id，不使用则不填写。 创建热词表信息请参考创建热词表。 needWordInfo 否 String 表示是否在识别结果中输出分词结果信息，取值为“yes”和“no”，默认为“no”。 伪代码 com.huaweicloud.sdk.sis.v1.model.Config configbody = new com.huaweicloud.sdk.sis.v1.model.Config();configbody.setAudioFormat(com.huaweicloud.sdk.sis.v1.model.Config.AudioFormatEnum.fromValue("pcm16k16bit")); configbody.setProperty(com.huaweicloud.sdk.sis.v1.model.Config.PropertyEnum.fromValue("chinese_16k_general")); configbody.setAddPunc(com.huaweicloud.sdk.sis.v1.model.Config.AddPuncEnum.YES); RecognizeShortAudioRequest request = new RecognizeShortAudioRequest(); PostShortAudioReq body = new PostShortAudioReq();body.withData(encoded);body.withConfig(configbody); request.withBody(body);

发送请求 RecognizeShortAudioResponse response = client.recognizeShortAudio(request); 返回体RecognizeShortAudioResponse的参数如下表所示。 状态码： 200 表2 响应Body参数 参数 是否必选 参数类型 描述 trace_id 是 String 服务内部的令牌，可用于在日志中追溯具体流程，调用失败无此字段。 在某些错误情况下可能没有此令牌字符串。 result 是 Result object 调用成功表示识别结果，调用失败时无此字段。 表3 Result 参数 是否必选 参数类型 描述 text 是 String 调用成功表示识别出的内容。 score 是 Float 调用成功表示识别出的置信度，取值范围：0~1。 word_info 否 Array of WordInfo objects 分词信息列表。 表4 WordInfo 参数 是否必选 参数类型 描述 start_time 否 Integer 起始时间。 end_time 否 Integer 结束时间。 word 否 String 分词。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。