[TOC] #### 一、界面测试 进入以下页面: ``` https://www.showapi.com/island/oneapi ``` 用户可自由输入文本查询,例如查询快递状态、天气预报、石油价格等。ONE API能够高效地识别和分析用户意图,并返回相应的内容。 ![](https://oss.showapi.com/doc/4743/5/54341c5b2a25_1704697665049.jpg?x-oss-process=image/resize,p_100) ------------ 支持文字问题+图片的形式,可结合文字、图片快速分析识别并返回内容。 上传图片如下图所示,点击框里的图标就会有上传图片的弹窗: ![](https://oss.showapi.com/doc/4743/5/910b33dd90bc_1704699445393.png?x-oss-process=image/resize,p_100) 上传成功就会如下图所示,此时再输入您想针对图片的提问,点击发送即可识别。 ![](https://oss.showapi.com/doc/4743/5/e70a5712ea08_1704699372115.png?x-oss-process=image/resize,p_100) #### 二、接口调用 1、HTTP调用 调用入参 ``` curl -X POST "https://route.showapi.com/3054-1" \ -d "showapi_appid: 你的密钥id" \ -d "showapi_sign: 你的密钥" \ -d "text=帮我查找一下昆明今天的天气" ``` 2、HTTP返回 接口返回完整的回复内容,可直接使用,也可根据返回的Json示例自行组织。还可根据返回的「意图」自行调用其他接口。 ![](https://oss.showapi.com/doc/4743/2/987f243b16cd_1704769081906.jpg?x-oss-process=image/resize,p_100) > 多种返回形式是指可以返回我们组织好的自然语言,还能返回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........\"]" ``` #### 三、应用场景示例 - 搜索问答:在搜索引擎或问答平台中,通过用户提出的问题,准确识别意图,并提供相关的答案和解决方案。 - 内容创作生成:为内容创作者提供辅助工具,根据用户输入的问题或需求,生成相关的内容片段、文章结构或创意灵感。 - 智能办公:在办公场景中,通过对话交互,帮助用户完成日常任务、查询信息、管理日程等工作。 - 客户服务与支持:用于构建智能客服或虚拟助手,能够理解用户的问题并提供准确的解答或协助。 - 语义分析与知识图谱:通过对话分析和意图识别,辅助构建知识图谱、语义理解模型或信息检索系统。 - 智能助理:将该接口集成到智能助理应用中,使用户能够通过对话与助理进行自然交互。用户可以提出问题、请求帮助、获取信息等,接口能够识别用户的意图并给出准确的回复或执行相应的操作。