# QQAI-API-SDK to Node.js

## 安装QQAI开放平台 Node.js SDK 非官方平台提供

所有测试文件来至网络 有版权啥的请联系我

* PC端测试地址：[https://ai.hltips.com/](https://ai.hltips.com)
* 微信端测试地址：![微信端测试](https://raw.githubusercontent.com/w89612b/qqai-api-sdk/master/newweb.jpg)

## npm安装依赖：

```sh
# install
npm install qqai-api-sdk
```

## 使用

```javascript
# use
const { Translate } = require('qqai-api-sdk');
const APP = {
  // 设置请求数据（应用密钥、接口请求参数）
  appkey: 'your appkey',
  appid: 'your appid'
}
const translate = new Translate(APP.appkey, APP.appid);
// 文本翻译（AI Lab）
translate.texttrans({text: '你好'}).then((res)=>{
  console.log('文本翻译(AI Lab)',JSON.stringify(res));
}, (e)=>{
  console.log('文本翻译(AI Lab)',JSON.stringify(e));
})
```

>**注意**：小程序·云开发 云函数必须[异步返回结果](https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/functions/async.html), 所以云函数写法如下：
>
>```
>exports.main = async (event, context) => {
>  return new Promise((resolve, reject) => {
>    translate.texttrans({
>      text: 'Hello 世界',
>      type: 0
>    }).then((res) => {
>      resolve(JSON.stringify(res));
>    }, (e) => {
>      reject(JSON.stringify(e));
>    })
>  });
>}
>```
>感谢使用者《追梦的人》（46914587）小伙伴使用提醒

## Node.js SDK目录结构

    ├── src
    │  ├── client                              //通用代理请求类
    │  ├── util                                //通用数据类
    │  ├── ApiBaseLanguae.js                   //自然语言处理-基本类
    │  ├── ApiFace.js                          //计算机视觉-面部识别类  
    │  ├── ApiImgPublic.js                     //计算机视觉-图片识别公共类  
    │  ├── ApiImgSpecialEffects.js             //计算机视觉-图片特效类  
    │  ├── ApiOCR.js                           //计算机视觉-ORC类  
    │  ├── ApiPersion.js                       //计算机视觉-人体管理类  
    │  ├── ApiSpeech.js                        //智能语音  
    │  ├── ApiTranslate.js                     //自然语言处理-翻译类  
    │  └── index.js                            //入口文件
    ├── test  
    │  ├── file                                //测试使用的相关文件存放地址
    │  ├── tta                                 //tta合成文件存放地址
    │  ├── tts                                 //tts合成文件存放地址
    │  ├── baseLanguae.js                      //自然语言处理-基本类 测试文件  
    │  ├── face.js                             //计算机视觉-面部识别 测试文件  
    │  ├── imgpulic.js                         //计算机视觉-图片识别公共类 测试文件  
    │  ├── ImgSpecialEffects.js                //计算机视觉-图片特效 测试文件  
    │  ├── OCR.js                              //计算机视觉-ORC 测试文件
    │  ├── Persion.js                          //计算机视觉-人体管理类 测试文件  
    │  ├── speech.js                           //智能语音 测试文件   语音识别-流式版（AI Lab）、语音识别-流式版(WeChat AI)、长语音识别  没有具体测试  
    │  ├── translate.js                        //自然语言处理-翻译类 测试文件  
    │  └── util.js                             //测试公用文件
    └── package.json                           //npm包描述文件

## 官方Demos

* [https://ai.qq.com/](https://ai.qq.com/)

## 日志  

2018年12月06日 版本 1.2.4  
>处理UTF8-URL编码和java、PHP不一致的问题————英文单引号

2018年09月29日 版本 1.2.3  
>智能语音类ApiSpeech添加语音关键词检索detectword方法  
>ProxyServices代理220行注释请求数据写入文件  

2018年06月21日 版本 1.2.2  
>恢复物体识别objectr接口format参数, 由于官方API已经修复这个参数  
>添加OCR接口类  加入车牌识别和手写体识别  

2018年04月18日 版本 1.2.1  
>暂时物体识别去掉objectr接口format参数, 由于加入format参数物体识别会报签名错误  
>微信小程序发布  由于微信个人账户的限制  带输入的内容无法发布 只能发布图片系列的

2018年03月27日 版本 1.2.0  
>处理签名处URL编码和java、PHP不一致的问题,解决例如语言类、翻译类需要清除空格的问题

2018年03月06日 版本 1.1.9  
>SDK 示例程序发布

2018年02月28日 版本 1.1.7  
>添加 计算机视觉-面部识别 跨年龄人脸识别接口-detectcrossageface

2018年02月25日  版本 1.1.7  
>修改数据回调，提升程序健壮性,代理不能解析为JSON时，将原文返回

2018年02月09日   版本 1.1.5
> 因为本人的粗心大意 造成大家在GBK编码的接口使用有问题  进行了修复  

2018年02月08日   版本 1.1.4  
> 为了减小包大小，将从1.1.5版本移除测试板块，只保留SDK内容，1.1.5版完全文件包请移步GitHub下载。 完整包包含SDK，本地测试文件， 本地测试服务文件等  
> 修改GBK转码方法 彻底解决GBK编码和服务器不同的问题  
> 修改签名方法 GBK发送方式会发送APPKEY  
> 修改原有普通测试文件名称为 SingleInterfaceTest.js  

2018年02月07日   版本 1.1.3  
> 添加 计算机视觉-人体管理 测试文件  
> 修改类 GBK编码相关的文件 公共类文件  连接代理类文件  
> 特别说明：文字需要GBK编码的接口不能包含半角对应的数字和大小写字母 其他均可  ，如需要用到字母和数字请用全角输入  半角字母和数字需要解决

2018年02月06日   版本 1.1.2  
> 添加 计算机视觉-图片特效 计算机视觉-面部识别 测试文件  
> 修改类 计算机视觉-人体管理类 从ApiFace类中迁入人脸识别和人脸验证  
> 计算机视觉-面部识别   移动人脸识别和人脸验证到APIPerson类中  

2018年02月05日   版本 1.1.1  
> 添加 自然语言处理-基本类 计算机视觉-图片识别公共类 测试文件  
> 自然语言处理-基本类 GBK 转码的问题 需要解决  
> 修改类 计算机视觉-图片识别公共类 创建方法
> 语音识别加入PCM文件正常识别
> 加入转码包 iconv-lite 依赖  

2018年02月04日   版本 1.1.0  
> 添加 语音测试 计算机视觉-ORC  修改部分注释  
> 修改 类创建验证BUG  

2018年02月03日  添加 计算机视觉 面部识别类、人体管理类、图片特效类  
2018年02月02日  添加 计算机视觉 图片识别公共类、ORC类

## 致歉

由于本人 于2018年02月03日 加入类创建验证写反，导致系列错误 对不起大家

## 详细使用文档

参考[QQAI开放平台官方文档](https://ai.qq.com/doc/index.shtml)

## License

[QQAI-API-SDK](https://github.com/w89612b/qqai-api-sdk) is released under [MIT licence](https://www.webrtc-experiment.com/licence/) . Copyright (c) [wubo](http://www.wubo.fun/).