文智快速上手指南

目录

1. API调用概述

1.1 通信协议和规则

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

1.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 请求签名,用来验证此次请求的合法性
具体参考接口鉴权页面

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

1.3 接口鉴权

接口鉴权方法详见《腾讯云接口鉴权》
注意:在生成签名的过程中,需要将加密字符串中包含的“_”改写成“.”,从而加密产生签名。

1.4 异步任务接口返回格式

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

1.5 错误码

详见《腾讯云错误码》

2. 调用示例

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

2.1 首先请在腾讯云官方sdk下载地址

https://github.com/QcloudApi/qcloudapi-sdk-php
下载或更新最新版本的sdk(本次以php-sdk为例);

2.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://www.qcloud.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";

以上信息是否解决您的问题?

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部