# API_final_project **Repository Path**: chen_ke_715/api_final_project ## Basic Information - **Project Name**: API_final_project - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2021-01-22 - **Last Updated**: 2025-04-02 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 特产淘——一个把家乡记忆留在身边的平台 ## 一、文档属性 文档名称 | 特产淘 ---|--- 版本 | 1.0 撰写人 | 陈珂 撰写时间|2021-01-20 状态|初稿 ### 加值宣言 本产品在“互联网 + 销售”的模式下进行家乡特产销售 ,平台建设服务对象为身在异乡的人们(主要是大学生),利用互联网技术与电商平台和快递服务相结合进行线上销售,提供了标准商品检测API技术、自然语言处理API技术、图像识别API技术以及语音识别API综合运用以为产品加值,帮助特产原产地商家入驻平台,用户通过平台购买商品并给予反馈,扩大了销售范围、降低了销售成本、 提高了销售效率。 ## 二、产品概述 ### 产品背景 随着互联网技术的发展,推动了中国多元消费的进程。线上 消费优势凸显出来,众多网络商城逐渐发展起来。“天猫”、“淘宝”、“京东”等各大电商应运而生,但是商城主要负责维护整个系统正常运行和平台的搭建,其商家的商品销售、商品种类没有统一规定,同时商品价格也没有根据品牌的层次给出标准,销售方式多样化,销售种类也不断增加,缺少专一化、规范化。 家乡特产作为一个重要的商品种类,销售方式也在不断发展。传统的销售模式下,销售范围狭窄,人流量不广,注重本地范围销售而忽略更大的市场。销售运营商可以批量销售各地的特产,运用强大的物流来分配各地需求,尤其是商对客的模式,可以让更了解自己特产的生产销售商直接面对想要购买或者是感兴趣的顾客,因此这种销售模式开始发展开来。 ### 市场分析   随着互联网时代的到来,农产品电商平台也实现了迅速发展,为我国土特产行业带来发展机遇,目前已经形成了以农户或农业合作社为基础,大型农业企业和主要的电商平台为核心,辅以政府部门的相关电商平台为指导。数据显示,2019年1-11月,全国农村网络零售额达15229亿元,同比增长19%。此外2019年全国农产品网络零售额达到3975亿元,较2016年增长1.5倍。  ### 产品简介 针对电商平台缺少专一化、规范化以及目标用户对特产购买的需求,该产品通过“互联网+销售”模式创建一个专门销售家乡特产的平台,商家可以通过文本审核、图像审核可以上传相关商品内容,用户可以通过文本搜索或以图搜图的形式在特产淘购买品尝到家乡的味道,并且用户可以通过浏览评价挑选商品,这让人与家人的距离通过网络紧密连接在一起。不仅加强了区域文化的传播与融合,促进贫困地区特产的销售,还可以提高贫困地区的经济效益,落实脱贫攻坚的政策。 ### 核心价值 #### 用户痛点 1.缺乏购买家乡特产的可靠、规范、专一的渠道; 2.通过传统销售模式,由批发商销售给中间商,最后通过各种渠道对接,过程繁琐、效率低,且成本高,降低了用户对商品的期望值。 #### 核心价值 “互联网 + 销售”的模式 下进行家乡特产销售 ,平台建设服务对象为身在异乡的人们,利用互联网技术与电商平台和快递服务相结合进行线上销售,提供了标准商品检测API技术、自然语言处理API技术、图像识别API技术、语音识别API扩大了销售范围、降低了销售成本、提高了销售效率。 ## 三、用户分析 ### 目标用户 目前中国大学生在校人数高达 3700 万,居全世界第一 , 用户量大,市场前景开阔。 ### 用户画像    - 核心用户:在外打工的上班族 - 主要用户:在校大学生 - 需求列表: 优先级 |用户需求|智能加值|API类型|API来源 ---|---|---|---|--- 1|在外打工的上班族想要购买家乡特产作为赠礼或者自身所需,保证质量| 文本审核API(查看评价反馈)|自然语言处理|百度AI开放平台 2| 在校大学生想要品尝家乡的味道,保证口味纯正| 图像识别API、图像审核API(查看商品外包装相似度,且保证商品不摻假)|图像识别|百度AI开放平台 3| 海外留学的学子想要将家乡的特色带到国外,并且降低对家乡的思念之情,保证供应充足且实时|图像搜索API|图像识别|百度AI开放平台 - 利害相关者分析  在产品设计上,需要对该张图的第一二象限的利益相关者尤为重视,尽最大能力满足他们的需求和提升他们的用户体验满意度;对于第二象限的利益相关者,需要给予一定程度的重视,随时掌握其与产品的相关性,比如实时关注博物馆文化事业的发展状况,根据变化更改完善产品;对于第三象限影响力小但相关度高的利益相关者,需要让他们充分了解情况并与他们交谈以帮助产品完善细节;对于第四象限的利益相关者,主要是持续关注他们,不必进行过度的沟通。 ## 四、产品原型 [特产淘1.0](https://modao.cc/app/33bd1f6b9adabb7a246c73df67b35b389c644586?simulator_type=device&sticky) ### [产品结构图](https://www.processon.com/mindmap/60081a750791294a0e9bd297)  ### [交互界面流程图](https://www.processon.com/diagraming/600814540791294a0e9bc61c)   ### [数据流程图](https://www.processon.com/diagraming/6006fa0f1e08534bec29ee79)  API|对象|数据流程 ---|---|--- 内容审核API、商品搜索入库API |商户|商户申请入驻-提交商品内容审核(文本+商品图片)-审核通过-商品搜索入库-成功入驻特产淘商城 语音识别API、商品搜索检索API、文本审核API |用户|注册成功-可以通过文字搜索/以图搜图/语音输入方式搜索商品-加入购物车-购买商品-完成收货-给予反馈-系统文本审核后显示用户评价 自然语言处理API|用户|查看评价-决定是否购买商品 ### 界面展示图  ### 数据简介 综合百度开放平台数据库、中国知网关于中国土特产市场报告数据以及特产图片数据 ## 人工智能概率性考量- API评估 本产品的API主要采用的是百度AI开放平台的[标准商品检测API技术](https://ai.baidu.com/solution/fmcg/sku)、[自然语言处理API技术](https://ai.baidu.com/tech/textcensoring)、[图像搜索API技术](https://ai.baidu.com/tech/imagesearch)、[语音识别API技术](https://ai.baidu.com/tech/speech)。 - 百度AI开放平台自然语言处理API技术 - 百度AI开放平台图像搜索API技术 - 百度AI开放平台语音识别API技术 ### API调用 #### [内容审核平台](https://ai.baidu.com/ai-doc/ANTIPORN/jk42xep4e) - 应用场景 - 视频内容审核:配合关键帧抽取技术对视频帧中的图像、字幕进行审核,搭配语音识别和敏感声音检测技术,对视频内容进行全面审核,当然如果您不想进行抽帧等操作,可以直接使用短视频审核接口 - 电商平台内容审核:针对商家的广告宣传文本,通过图文审核判断是否符合新广告法,在双11、618、黑色星期五等购物节,通过百度内容审核,极大的弥补人力审核资源不足的问题,实时快速的对商品信息进行审核,保障平台内容安全 - UGC内容反垃圾:对论坛、贴吧等UGC内容中的图片、文章、评论进行合规性检查,并针对恶意推广、政治敏感、低俗辱骂、低质灌水内容进行审核,降低平台违规风险、有效提升平台内容质量、吸引更多用户与优质资源 1. 图像审核 接口地址:https://aip.baidubce.com/rest/2.0/solution/v1/img_censor/v2/user_defined 请求方式:POST 接口说明:内容审核平台-图像接口 请求参数说明: URL参数:
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
| 参数 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
| 参数名称 | 数据类型 | 是否必须 | 备注 | 样例 |
|---|---|---|---|---|
| image | String | N (和imgUrl二选一) |
待审核图像Base64编码字符串, 以图像文件形式请求时必填, 图像要求base64后 大于等于5kb,小于等于4M, 最短边大于等于128像素, 小于等于4096像素, 支持的图片格式:PNG、JPG、JPEG、BMP、GIF(仅对首帧进行审核)、Webp、TIFF |
/9j/4AAQSkZJRgABAQ AASABIAAD/4QBYRXh pZgAATU0AKgAAAAgA AgESAAMAAAABAAYAAIdp |
| imgUrl | String | N (和image二选一) |
图像URL地址, 以URL形式请求, 图像Url需要做UrlEncode, 图像要求base64后大于等于5kb, 小于等于4M, 最短边大于等于128像素, 小于等于4096像素 支持的图片格式:PNG、JPG、JPEG、BMP、GIF(仅对首帧进行审核)、Webp、TIFF |
https://ai-solution-admin.cdn.bcebos.com/audit%2Fdemo%2Fcensoring-demo.jpg |
| imgType | uint64 | N | 图片类型0:静态图片(PNG、JPG、JPEG、BMP、GIF(仅对首帧进行审核)、Webp、TIFF),1:GIF动态图片 | 0 |
| 参数名称 | 数据类型 | 是否必须 | 备注 | 样例 |
|---|---|---|---|---|
| text | String | N | 待审核文本字符串 | "不要侮辱伟大的乐侃" |
| 服务名称 | 能力简要描述 |
|---|---|
| 相同图片搜索 | 在自建图库中找到与检索图相同的图片,支持找到局部内容相同的大图,或适度调整背景和角度的相同图片;可用于图片精确查找、重复图片过滤等场景。 |
| 相似图片搜索 | 在自建图库中找到与检索图片语义相似的图片集,并给出相似度打分(综合图片类型、颜色、内容、布局等特征);适用于各种相似图片查找、相关内容推荐场景。 |
| 商品图片搜索 | 针对商品类图片,专项训练检索模型,在自建图库中搜索相同及相似的商品图片集,可找到不同颜色、背景、角度的同款商品;适用于电商平台拍照搜商品、相关商品推荐等场景。 |
| 绘本图片搜索(邀测) | 可在自建图库中找到与检索图相同的绘本图片、儿童书本教材。支持用局部绘本页,找到内容相同的大图;可用于绘本、图书、教材的精确查找、重复图片过滤等场景。 |
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
| 参数 | 值 |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
| 参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
|---|---|---|---|---|
| image | 否 | string | - | 图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M。和url二选一,image优先级更高,注意要去掉图片头部,如(data:image/jpg;base64,),最短边至少300px,最长边最大4096px,支持jpg/png/bmp格式。重复添加会返回错误。 |
| url | 否 | string | - | 图片URL,和image二选一,image优先级更高 ,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传 |
| brief | 是 | string | - | 检索时原样带回,最长256B。样例{"name":"周杰伦", "id":"666"} 请注意,检索接口不返回原图,仅返回当前填写的brief信息,所以调用入库接口时,brief信息请尽量填写可关联至本地图库的图片id或者图片url、图片名称等信息 |
| class_id1 | 否 | int32 | 1-65535范围内的整数 | 商品分类维度1,检索时可圈定该分类维度进行检索;只传入class_id1,则检索结果中包含class_id1内容的都会被检索到;同时传入class_id1与class_id2,则检索结果中同时包含class_id1和class_id2内容的才会被检索到 |
| class_id2 | 否 | int32 | 1-65535范围内的整数 | 商品分类维度2,检索时可圈定该分类维度进行检索 ,class_id1和class_id2无层级关系,检索时支持逻辑运算 |
| 字段 | 是否必选 | 类型 | 说明 |
|---|---|---|---|
| log_id | 是 | uint64 | 唯一的log id,用于问题定位 |
| cont_sign | 是 | string | 上传图片的签名信息,请务必保存至本地,以便后续用作批量删除、查询某张图是否已经入过库等用途 |
| 参数 | 类型 | 描述 | 是否必须 |
|---|---|---|---|
| speech | Buffer | 建立包含语音内容的Buffer对象, 语音文件的格式,pcm 或者 wav 或者 amr。不区分大小写 | 是 |
| format | String | 语音文件的格式,pcm 或者 wav 或者 amr。不区分大小写。推荐pcm文件 | 是 |
| rate | int | 采样率,16000、8000,固定值 | 是 |
| cuid | String | 用户唯一标识,用来区分用户,填写机器 MAC 地址或 IMEI 码,长度为60以内 | 否 |
| dev_pid | Int | 不填写lan参数生效,都不填写,默认1537(普通话 输入法模型),dev_pid参数见本节开头的表格 | 否 |
| lan(已废弃) | String | 历史兼容参数,请使用dev_pid。如果dev_pid填写,该参数会被覆盖。语种选择,输入法模型,默认中文(zh)。 中文=zh、粤语=ct、英文=en,不区分大小写。 | 否 |
| dev_pid | 语言 | 模型 | 是否有标点 | 备注 |
|---|---|---|---|---|
| 1537 | 普通话(纯中文识别) | 输入法模型 | 有标点 | 支持自定义词库 |
| 1737 | 英语 | 无标点 | 不支持自定义词库 | |
| 1637 | 粤语 | 有标点 | 不支持自定义词库 | |
| 1837 | 四川话 | 有标点 | 不支持自定义词库 | |
| 1936 | 普通话远场 | 远场模型 | 有标点 | 不支持 |
| 参数 | 类型 | 是否一定输出 | 描述 |
|---|---|---|---|
| err_no | int | 是 | 错误码 |
| err_msg | int | 是 | 错误码描述 |
| sn | int | 是 | 语音数据唯一标识,系统内部产生,用于 debug |
| result | int | 是 | 识别结果数组,提供1-5 个候选结果,string 类型为识别的字符串, utf-8 编码 |