开放能力
开发平台
行业应用
生态合作
开发与教学
资讯 社区 控制台
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术
AR与VR
数据智能
场景方案
部署方案
行业应用
智能教育
智能医疗
智能零售
智能工业
企业服务
智能政务
信息服务
智能园区

调用API

本文档主要说明定制化模型本地部署后,如何使用本地API。如还未训练模型,请先前往EasyDL进行训练。

如有疑问可以通过以下方式联系我们:

  • 在百度云控制台内提交工单
  • 进入EasyDL社区交流 ,与其他开发者进行互动
  • 加入EasyDL官方QQ群(群号:868826008)联系群管

部署包使用说明

EasyDL定制化文本分类模型的本地部署通过EasyPack实现,目前提供单机一键部署的方式。

在EasyDL控制台申请、下载部署包后,可以参考EasyPack-单机一键部署将软件包部署在本地服务器上。部署成功后,启动服务,即可调用与在线API功能类似的接口。

授权说明

本地部署包根据服务器硬件(CPU单机或GPU单卡)进行授权,只能在申请时提交的硬件指纹所属的硬件上使用。

部署包测试期为1个月,如需购买永久授权,可提交工单咨询

API参考

请求说明

请求示例

HTTP 方法:POST

请求URL:请首先在EasyDL进行自定义模型训练,完成训练后申请本地部署,本地部署成功后拼接url。

请求URL: http://{IP}:{PORT}/{DEPLOY_NAME}/TextClassification

  • IP:服务本地部署所在机器的ip地址
  • PORT:服务部署后获取的端口
  • DEPLOY_NAME:申请时填写的本地服务名称

Header如下:

参数
Content-Type application/json

Body请求示例:

{
    "text": "电影故事结构很松散,但是小丽的演技一如既往的不错,配合她的男演员挺好的,比如说小杰,他在对手戏中有很强的互动性",
    "analyse_object":  "小丽 ",
    "analyse_type ":1
}

Body中放置请求参数,参数详情如下:

请求参数

参数 是否必选 类型 可选值范围 说明
text string - 超过512个token将被截断
analyse_object string - 评论实体对象
analyse_type int 1/2/3/4 只能选择枚举值的一个

返回说明

返回参数

字段 是否必选 类型 说明
analyse_type int 1代表评价片段,2代表评价维度,3代表评价观点词,4代表评价情感倾向;示例:analyse_type:"1"或analyse_type:"4",每次请求仅为单值;
log_id number 唯一的log id,用于问题定位
result array(object) 需要计算的评价对象数组,元素为字典
+start_offset int 开始位置
+prob float 置信度
+end_offset int 结束位置
+text string 抽取文本
text string 输入文本,超过512个token将被截断

返回示例

{
    "analyse_type": 1,
    "log_id": 7000918336750814000,
    "result": [
        {
            "start_offset": 10,
            "prob": 0.4721265733242,
            "end_offset": 24,
            "text": "但是小丽的演技一如既往的不错"
        }
    ],
    "text": "电影故事结构很松散,但是小丽的演技一如既往的不错,配合她的男演员挺好的,比如说小杰,他在对手戏中有很强的互动性"
}

错误码

若请求错误,服务器将返回的JSON文本包含以下参数:

  • error_code:错误码。
  • error_msg:错误描述信息,帮助理解和解决发生的错误。

例如缺少必要出入参时返回:

{
  "error_code": 336001,
  "error_msg": "Invalid Argument"
}
错误码 错误信息 描述
336000 Internal error 服务器内部错误,请再次请求, 如果持续出现此类错误,请通过QQ群(868826008)或工单联系技术支持团队
336001 Invalid Argument 入参格式有误,比如缺少必要参数、文本的编码UTF-8等问题。有疑问请通过QQ群(868826008)或工单联系技术支持团队
336002 JSON不合法 入参格式或调用方式有误,比如缺少必要参数代码格式是否有误。有疑问请通过QQ群(868826008)或工单联系技术支持团队
336003 Base64解码失败 图片/音频/文本格式有误或base64编码有误,请根据接口文档检查格式,base64编码请求时注意要去掉头部。有疑问请通过QQ群(868826008)或工单联系技术支持团队
336004 输入文件大小不合法 文本大小不合法,目前支持文本文件类型为支持txt,文本文件大小限制长度最大1024 UTF-8字符。有疑问请通过QQ群(868826008)或工单联系技术支持团队
336005 解码失败 文本编码错误(不是utf-8),目前支持文本文件类型为支持txt。如果遇到请重试,如反复失败,请在百度云控制台内提交工单反馈
336006 缺失必要参数 未上传文本文件
336100 model temporarily unavailable 遇到该错误码请等待1分钟后再次请求,可恢复正常,若反复重试依然报错或有疑问请通过QQ群(868826008)或工单联系技术支持团队
337000 Auth check failed 离线鉴权调用失败
上一篇
发布API
下一篇
文本创作