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

API参数集 用户通过指定API参数来获取对应的结果，语言云服务的API参数集如下表所示： 参数名 含义 说明 api_key 用户注册语音云服务后获得的认证标识 text 待分析的文本 请以UTF-8格式编码，GET方式最大10K，POST方式最大20K pattern 用以指定分析模式，可选值包括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中使用REST REST REST,或者叫做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 VOB POST请求及返回结果示例： $ 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编程调用示例。 JavaS