AI 助教标准接口

最近更新时间:2019-07-24 15:33:59

1. 接口描述

接口请求域名: tci.tencentcloudapi.com 。

提供 AI 助教基础版本功能接口

默认接口请求频率限制:20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:AIAssistant
Version String 公共参数,本接口取值:2019-03-18
Region String 公共参数,本接口不需要传递此参数。
FileContent String 输入分析对象内容
FileType String 输入分析对象类型,picture_url:图片地址,vod_url:视频地址,live_url:直播地址,audio_url: 音频文件
Lang Integer 音频源的语言,默认0为英文,1为中文
LibrarySet.N Array of String 查询人员库列表
Template Integer 标准化模板选择:0:AI助教基础版本,1:AI评教基础版本,2:AI评教标准版本。AI 助教基础版本功能包括:人脸检索、人脸检测、人脸表情识别、学生动作选项,音频信息分析,微笑识别。AI 评教基础版本功能包括:人脸检索、人脸检测、人脸表情识别、音频信息分析。AI 评教标准版功能包括人脸检索、人脸检测、人脸表情识别、手势识别、音频信息分析、音频关键词分析、视频精彩集锦分析。
VocabLibNameList.N Array of String 识别词库名列表,评估过程使用这些词汇库中的词汇进行词汇使用行为分析
VoiceEncodeType Integer 语音编码类型 1:pcm
VoiceFileType Integer 语音文件类型 1:raw, 2:wav, 3:mp3,10:视频(三种音频格式目前仅支持16k采样率16bit)

3. 输出参数

参数名称 类型 描述
ImageResults Array of ImageTaskResult 图像任务直接返回结果
TaskId Integer 任务ID
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 发起 AI 助教

发起 AI 助教,选择基础班功能

输入示例

https://tci.tencentcloudapi.com/?Action=AIAssistant
&FileContent=https%3A%2F%2Fedu-test-1253131631.cos.ap-guangzhou.myqcloud.com%2Faieduautotest%2Fautotest_vedio.mp4
&FileType=vod_url
&Lang=0
&LibrarySet.0=library_15603955264181591716
&VocabLibNameList.0=testlib2
&VoiceEncodeType=1
&VoiceFileType=10
&<公共请求参数>

输出示例

{
  "Response": {
    "TaskId": 2516205217,
    "ImageResults": null,
    "RequestId": "82d23aac-ff81-4821-bd58-99d2caf6136f"
  }
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
InvalidParameter.ProcessUnReady 任务处理中,请稍后查询。
InvalidParameter.StatusJobFailed 任务执行失败,请确保拉流地址稳定
InvalidParameter.StatusJobUnfinished 任务未完成