文档平台 API 中心 文智自然语言处理 API调用快速上手指南

API调用快速上手指南

最近更新时间:2018-06-11 15:59:03

1 介绍

腾讯文智自然语言处理(Natural Language Processing)基于并行计算、分布式爬虫系统,结合独特的语义分析技术,一站满足NLP、转码、抽取、数据抓取等需求。基于文智API可实现搜索、推荐、舆情、挖掘等功能。文智同时支持定制化语义分析方案。

腾讯云文智中文语义平台以SDK模块的方式提供服务,多种编程语言都可以轻松使用。在正式使用之前,您需要首先在腾讯云上注册文智账号。

2 API调用概述

2.1 通信协议和规则

详见《腾讯云通信协议和规则》

2.2 公共参数

公共参数是用于标识用户和接口鉴权的参数, 每次请求均需要携带这些参数, 才能正常发起请求。

名称 类型 描述 必选
Action String 接口指令的名称,例如: LexicalAnalysis
Region String 区域参数,用来标识希望操作哪个区域的实例。可选: gz:广州; sh:上海;hk:香港;等部分云产品并非每个区域都有提供, 获取产品对应的地域列表可以使用/v2/DescribeProductRegionList
Timestamp UInt 当前UNIX时间戳
Nonce UInt 随机正整数,与Timestamp联合起来, 用于防止重放攻击
SecretId String 由腾讯云平台上申请的标识身份的SecretId和SecretKey, 其中SecretKey会用来生成Signature
具体参考接口鉴权页面
Signature String 请求签名,用来验证此次请求的合法性
具体参考接口鉴权页面

公共参数详见《腾讯云公共参数》

2.3 接口鉴权

接口鉴权方法详见《接口鉴权》

注意:在生成签名的过程中,需要将加密字符串中包含的“_”改写成“.”,从而加密产生签名。

2.4 异步任务接口返回格式

详见《腾讯云异步任务接口返回格式》

2.5 错误码

详见《调用方式-返回值-错误码》

3 调用示例

这里将以一个简单的情感分析任务为例,介绍腾讯云SDK文智模块的使用。

3.1 首先请在腾讯云官方SDK下载地址

下载或更新最新版本的SDK(本次以php-sdk为例)

3.2 修改demo.php文件,修改点如下

a) SecretId,SecretKey改为自己腾讯云上相应的值,这里查看:

http://manage.qcloud.com/capi/capiManage.php

b)$package=array('offset'=>0, 'limit'=>3); 改为:

$package = array("content"=>"李亚鹏挺王菲:加油!孩儿他娘。");

说明:这是文智情感分析接口的参数。

c)$a=$cvm->DescribeInstances($package); 改为:

$a = $wenzhi->TextSentiment($package);

说明:这是文智模块的相关接口,具体请查看接口列表:
http://cloud.tencent.com/wiki/v2/API

d)其他所有地方的$cvm改为$wenzhi,即替换为文智模块。

修改后的demo.php如下:

<?php
error_reporting(E_ALL ^ E_NOTICE);
require_once './src/QcloudApi/QcloudApi.php';

$config = array('SecretId'        => '您在腾讯云上的SecretId',
             'SecretKey'       => '您在腾讯云上的SecretKey',
             'RequestMethod'  => 'POST',
             'DefaultRegion'    => 'gz');

$wenzhi = QcloudApi::load(QcloudApi::MODULE_WENZHI, $config);

$package = array("content"=>"李亚鹏挺王菲:加油!孩儿他娘。");

$a = $wenzhi->TextSentiment($package);

if ($a === false) {
    $error = $wenzhi->getError();
    echo "Error code:" . $error->getCode() . ".\n";
    echo "message:" . $error->getMessage() . ".\n";
    echo "ext:" . var_export($error->getExt(), true) . ".\n";
} else {
    var_dump($a);
}

echo "\nRequest :" . $wenzhi->getLastRequest();
echo "\nResponse :" . $wenzhi->getLastResponse();
echo "\n";

如果有其他疑问,您也可以在问答社区中寻求帮助。前往问答社区 >