本文介绍通义听悟 Java SDK,帮助开发者快速调用服务。
前提条件
当您需要为第三方应用或用户提供临时访问权限,或者希望严格控制敏感数据访问、删除等高风险操作时,建议使用临时鉴权Token。与长期有效的 API Key 相比,临时鉴权 Token 具备时效性短(60秒)、安全性高的特点,适用于临时调用场景,能有效降低API Key泄露的风险。使用方式:在代码中,将原本用于鉴权的 API Key 替换为获取到的临时鉴权 Token 即可。
- 安装最新版DashScope SDK(DashScope版本号须>=2.21.1)
接口说明
TingWuParam.java
参数配置类。以汽车销售服务洞察为例,创建任务主要参数如下,更多参数说明请参见汽车销售服务洞察API参考或购车客户画像API参考:
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| model | string | 是 | 定义业务类型具体参数请参见API参考 | tingwu-automotive-service-insights |
| input | object | 是 | 传入相关业务参数 | |
| input.fileUrl | string | 3选1 | 待分析文件oss URL地址,sdk调用 | https://.oss-cn-hangzhou.aliyuncs.com/%E8%AF%95%E9%A9%BE%E6%A1%88%E4%BE%8Bsmall.wav?OSSAccessKeyId=YOUR_ACCESS_KEY_ID&Expires=&Signature=YOUR_SIGNATURE |
| input.text | string | 待分析文本 | 每行必须按照如下格式:${发言人名称}: ${发言人内容}例子比如: | |
| input.dataId | string | 关联已上传并解析完成的任务 | ||
| input.appId | string | 是 | 应用id | |
| input.task | string | 是 | 定义任务类型:
| createTask |
| parameters | object | 否 | 请求参数(若传入空对象则复用已发布上线的配置项)具体参数请参见API参考 |
示例代码
TingWu.java
- 听悟 Http服务接口类。
- 发送请求,返回响应结果。
响应结果
以汽车销售服务洞察为例,主要返回参数如下,更多说明请参见汽车销售服务洞察API参考或购车客户画像API参考:
名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
output | object | ||
output.dataId | string | 任务id | |
output.status | string |
| 0 |
usage | object | ||
code | string | 错误码 | InvalidParameter |
message | string | 错误信息 | Agent Input text format error. |
request_id | string | 请求id | f97ee37d-0f9c-9b93-b6bf-bd263a232bf9 |