OneAPI使用说明
[TOC]
#### 一、界面测试
进入以下页面:
```
https://www.showapi.com/island/oneapi
```
用户可自由输入文本查询,例如查询快递状态、天气预报、石油价格等。ONE API能够高效地识别和分析用户意图,并返回相应的内容。

------------
支持文字问题+图片的形式,可结合文字、图片快速分析识别并返回内容。
上传图片如下图所示,点击框里的图标就会有上传图片的弹窗:

上传成功就会如下图所示,此时再输入您想针对图片的提问,点击发送即可识别。

#### 二、接口调用
1、HTTP调用
调用入参
```
curl -X POST "https://route.showapi.com/3054-1" \
-d "showapi_appid: 你的密钥id" \
-d "showapi_sign: 你的密钥" \
-d "text=帮我查找一下昆明今天的天气"
```
2、HTTP返回
接口返回完整的回复内容,可直接使用,也可根据返回的Json示例自行组织。还可根据返回的「意图」自行调用其他接口。

> 多种返回形式是指可以返回我们组织好的自然语言,还能返回json格式,程序员可以自己组织。
附接口链接https://www.showapi.com/apiGateway/onlineTest?apiCode=3054&pointCode=1
3、带上传文件的调用
如果在调用时需要传入更多参数,比如`帮我识别下这个图的内容`,除了传入文字以外,还需要传入图片内容。在本接口中使用base64传输图片、音视频等额外字段。如下例:
```
curl -X POST "https://route.showapi.com/3054-1" \
-d "showapi_appid: 你的密钥id" \
-d "showapi_sign: 你的密钥" \
-d "text=帮我识别下这个图的内容" \
-d "args_list=[\"base64........\"]"
```
#### 三、应用场景示例
- 搜索问答:在搜索引擎或问答平台中,通过用户提出的问题,准确识别意图,并提供相关的答案和解决方案。
- 内容创作生成:为内容创作者提供辅助工具,根据用户输入的问题或需求,生成相关的内容片段、文章结构或创意灵感。
- 智能办公:在办公场景中,通过对话交互,帮助用户完成日常任务、查询信息、管理日程等工作。
- 客户服务与支持:用于构建智能客服或虚拟助手,能够理解用户的问题并提供准确的解答或协助。
- 语义分析与知识图谱:通过对话分析和意图识别,辅助构建知识图谱、语义理解模型或信息检索系统。
- 智能助理:将该接口集成到智能助理应用中,使用户能够通过对话与助理进行自然交互。用户可以提出问题、请求帮助、获取信息等,接口能够识别用户的意图并给出准确的回复或执行相应的操作。