私有部署文档-序列标注
本文档主要说明定制化模型本地部署后,如何使用本地API。如还未训练模型,请先前往BML进行训练。
如有疑问可以通过以下方式联系我们:
- 在百度智能云控制台内提交工单
- 进入EasyDL社区交流 ,与其他开发者进行互动
- 加入BML官方QQ群(群号:868826008)联系群管
部署包使用说明
BML定制化序列标注模型的本地部署通过EasyPack实现,目前提供单机一键部署的方式。
在BML控制台申请、下载部署包后,可以参考EasyPack-单机一键部署将软件包部署在本地服务器上。部署成功后,启动服务,即可调用与在线API功能类似的接口。
授权说明
本地部署包根据服务器硬件(CPU单机或GPU单卡)进行授权,只能在申请时提交的硬件指纹所属的硬件上使用。
部署包测试期为1个月,如需购买永久授权,可提交工单咨询
API参考
请求说明
请求示例
HTTP 方法:POST
请求URL:请首先在BML进行自定义模型训练,完成训练后申请本地部署,本地部署成功后拼接url。
请求URL:http://{IP}:{PORT}/{DEPLOY_NAME}/SequenceLabel
- IP:服务本地部署所在机器的ip地址
- PORT:服务部署后获取的端口
- DEPLOY_NAME:申请时填写的本地服务名称
Header如下:
参数 | 值 |
---|---|
Content-Type | application/json |
Body请求示例:
{
"text": "<UTF-8编码数据>"
}
Body中放置请求参数,参数详情如下:
请求参数
参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
---|---|---|---|---|
text | 是 | string | - | 文本数据,UTF-8编码。最大长度512个汉字,注意,文本必须以空格分隔的字/词 |
返回说明
返回参数 | 字段 | 是否必选 | 类型 | 说明 | | ---------- | -------- | ------------- | -------------------------- | | log_id | 是 | number | 唯一的log id,用于问题定位 | | raw_text | 否 | array(string) | 原始输入,按空格切分 | | label | 否 | array(string) | 标注结果 | | error_code | 否 | number | 错误码 | | error_msg | 否 | string | 错误信息 |
错误码
若请求错误,服务器将返回的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 | 输入文件大小不合法 | 文本超出大小限制,文本限4M以内,请根据接口文档检查入参格式,有疑问请通过QQ群(868826008)或工单联系技术支持团队 |
336005 | 文本解码失败 | 文本编码错误(不是utf-8) |
336006 | 缺失必要参数 | 文本字段内容缺失 |
336100 | model temporarily unavailable | 遇到该错误码请等待1分钟后再次请求,可恢复正常,若反复重试依然报错或有疑问请通过QQ群(868826008)或工单联系技术支持团队 |
337000 | Auth check failed | 离线鉴权调用失败 |