科大讯飞语音云使用说明.docx

API参数集用户通过指定API参数来获取对应的结果，语言云服务的API参数集如下表所示：参数名含义说明api_key用户注册语音云服务后获得的认证标识text待分析的文本请以UTF-8格式编码，GET方式最大10K，POST方式最大20Kpattern用以指定分析模式，可选值包括ws(分词)，pos(词性标注)，ner(命名实体识别)，dp(依存句法分析)，srl(语义角色标注),all(全部任务)plain格式中不允许指定全部任务format用以指定结果格式类型，可选值包括xml(XML格式)，json(JSON格式)，conll(CONLL格式)，plain(简洁文本格式)xml_input用以指定输入text是否是xml格式，可选值为false(默认值),true仅限POST方式has_key用以指定json结果中是否含有键值，可选值包括true(含有键值，默认)，false(不含有键值)配合format=json使用only_ner用以指定plain格式中是否只需要ner列表，可选值包括false(默认值)和true配合pattern=nerformat=plain使用callback用以指定JavaScript调用中所使用的回调函数名称配合format=json使用******************************************************************************调用方式用户可以用两种方式来调用API，直接使用REST?|?在JavaScript中使用RESTRESTREST,或者叫做Representational State Transfer，在语言云API中并不等同于传统的REST。传统的REST提供对于资源的访问，而语言云REST API提供对于服务的访问。因此，在语言云API中，一个单独的URI就是一个服务端点。在语言云中，所有的API访问都是通过HTTP请求的方式。并且需要从域进行访问。语言云只支持GET和POST方式的HTTP请求。用户通过在HTTP请求中指定参数来获取对应的结果。举个例子，对“我是中国人。”这句话做依存句法分析，并且返回plain格式的结果。GET请求及返回结果示例：$ curl -i?/analysis/?api_key=YourApiKeytext=我是中国人。pattern=dpformat=plainHTTP/1.1 200 OKServer: nginx/1.1.19Date: Fri, 03 Jan 2014 04:24:32 GMTContent-Type: text/plainTransfer-Encoding: chunkedConnection: keep-aliveVary: Accept-Encoding是_1?-1?HED中国_2?人_3 ATT人_3?是_1 VOBPOST请求及返回结果示例：$ curl -i -d?api_key=YourApiKeytext=我是中国人。pattern=dpformat=plain /analysis/HTTP/1.1 200 OKServer: nginx/1.1.19Date: Fri, 03 Jan 2014 05:58:55 GMTContent-Type: text/plainTransfer-Encoding: chunkedConnection: keep-aliveVary: Accept-Encoding我_0?是_1 SBV是_1?-1?HED中国_2?人_3 ATT人_3?是_1 VOB使用Python语言以GET方式调用REST API代码示例如下：1.?# -*- coding:utf8 -*-?2.import urllib2?3.if __name__ ==?__main__:?4.?url_get_base =?/analysis/??5.?api_key =??6.?text =??7.?format =??8.?pattern =??9.?result = urllib2.urlopen(?%sapi_key=%stext=%sformat=%spattern=%s?% (url_get_base,api_key,text,format,pattern))?10.?content = result.read().strip()?11.?print content更多使用其他编程语言以GET和POST方式调用REST API代码示例以及注意事项请参考API编程调用示例。JavaScript调用REST语言云支持用户使用JavaScript以JSON-P回调的方式调用API，用户需要以GET方式进行调用并且只支持json的返回格式。在