手部异常识别 HTTP 服务 - API 文档一、概述本服务提供基于 HTTP 的手部图像检测接口可识别手部是否存在以下情况手部完整、美甲、手部伤口、佩戴戒指、长指甲、灰指甲。项目说明默认地址http://服务端IP:5000协议HTTP/1.1数据格式请求/响应均为 JSON除上传文件为 multipart图片可传文件或 Base64编码建议 UTF-8二、通用约定2.1 统一响应结构除健康检查外业务接口均采用以下 JSON 结构成功时{success:true,message:检测成功,data:{...}}字段类型说明successboolean是否成功messagestring提示信息dataobject / null业务数据失败时为 null失败时如 400{success:false,message:错误描述,data:null}2.2 HTTP 状态码状态码说明200成功400请求参数错误如未上传图片、图片无法解码500服务端检测异常三、接口列表3.1 健康检查用于探测服务是否存活不涉及图片与业务逻辑。请求项目说明方法GET路径/health请求体无响应状态码说明200服务正常响应体示例{status:ok}调用示例curl-XGET http://127.0.0.1:5000/health3.2 仅返回识别结果不返回图片上传一张图片返回手部检测结果JSON不包含标注图。适合只需结构化结果的场景。请求项目说明方法POST路径/detectContent-Type见下方两种方式二选一方式一表单上传图片文件Content-Type: multipart/form-data表单字段名必须为image值为图片文件如 .jpg、.png方式二JSON 传 Base64 图片Content-Type: application/json请求体为 JSON且包含以下字段之一image_base64图片的 Base64 编码字符串imageBase64同上兼容驼峰命名Base64 可带data:image/jpeg;base64,等前缀服务会自动截取逗号后的内容解码响应成功 200data结构字段类型说明summarystring[]简短结果摘要如[美甲: 85.0% [稳定], 手部完整: 90.0% [稳定]]detectionsobject[]检测项列表每项见下表hand_countnumber检测到的手的数量0 或 1 等detections 每项字段字段类型说明typestring类型标识见「识别类型枚举」class_namestring中文名称confidencenumber置信度 0~1boxnumber[] | null可选边界框 [x1, y1, x2, y2]像素坐标响应体示例成功{success:true,message:检测成功,data:{summary:[美甲: 85.0% [稳定],手部完整: 90.0% [稳定]],detections:[{type:nail_art,class_name:美甲,confidence:0.85,box:[120,200,180,260]},{type:normal,class_name:手部完整,confidence:0.9,box:[80,100,400,480]}],hand_count:1}}响应体示例失败 400{success:false,message:请上传图片 (字段名 image),data:null}调用示例# 表单上传文件curl-XPOST http://127.0.0.1:5000/detect-Fimage/path/to/photo.jpg# JSON Base64将 YOUR_BASE64_STRING 替换为实际 Base64curl-XPOST http://127.0.0.1:5000/detect\-HContent-Type: application/json\-d{image_base64:YOUR_BASE64_STRING}3.3 返回识别结果 标注图Base64上传一张图片返回识别结果的同时返回一张在图上画好检测框与文字的标注图JPEG以 Base64 形式放在data.image_base64。适合需要“原图结果图”的场景。请求与3.2 仅返回识别结果完全一致仅路径不同。项目说明方法POST路径/detect_imageContent-Typemultipart/form-data字段image或application/json字段image_base64/imageBase64响应成功 200data在 3.2 的基础上多一个字段字段类型说明summarystring[]同 3.2detectionsobject[]同 3.2hand_countnumber同 3.2image_base64string标注后的图片JPEG的 Base64 编码可直接用于展示或保存为 .jpg响应体示例成功仅摘录 data{success:true,message:检测成功,data:{summary:[美甲: 85.0% [稳定]],detections:[{type:nail_art,class_name:美甲,confidence:0.85,box:[120,200,180,260]}],hand_count:1,image_base64:/9j/4AAQSkZJRgABAQEASABIAAD/2wBD...}}前端使用示例将返回的 base64 显示为图片imgsrcdata:image/jpeg;base64,{{ data.image_base64 }}/调用示例curl-XPOST http://127.0.0.1:5000/detect_image-Fimage/path/to/photo.jpg四、识别类型枚举检测结果中的type与class_name对应关系如下typeclass_namenormal手部完整nail_art美甲wound手部伤口ring佩戴戒指long_nail长指甲fungal_nail灰指甲同一张图中可能同时返回多项如既有normal也有nail_art以实际检测为准。五、常见错误 messagemessage原因处理建议请上传图片 (字段名 image)使用 multipart 时未带image或文件为空检查表单字段名为image且选择了文件请提供 image_base64使用 JSON 时未传 base64 字段使用image_base64或imageBase64无法解码图片 / Base64 图片解码失败图片损坏或非图片格式确认为合法 jpg/png 等Base64 解码失败Base64 字符串非法检查编码是否正确、无换行/空格截断请使用 multipart/form-data (image 文件) 或 application/json (image_base64)Content-Type 既不是表单也不是 JSON按文档使用两种方式之一检测异常: xxx服务端推理出错查看服务端日志确认图片尺寸/格式合理六、附录接口速览方法路径说明GET/health健康检查POST/detect上传图片仅返回识别结果JSONPOST/detect_image上传图片返回识别结果 标注图 Base64所有 POST 接口的图片输入方式表单字段image或JSON 字段image_base64/imageBase64。
AI识别手部异常
手部异常识别 HTTP 服务 - API 文档一、概述本服务提供基于 HTTP 的手部图像检测接口可识别手部是否存在以下情况手部完整、美甲、手部伤口、佩戴戒指、长指甲、灰指甲。项目说明默认地址http://服务端IP:5000协议HTTP/1.1数据格式请求/响应均为 JSON除上传文件为 multipart图片可传文件或 Base64编码建议 UTF-8二、通用约定2.1 统一响应结构除健康检查外业务接口均采用以下 JSON 结构成功时{success:true,message:检测成功,data:{...}}字段类型说明successboolean是否成功messagestring提示信息dataobject / null业务数据失败时为 null失败时如 400{success:false,message:错误描述,data:null}2.2 HTTP 状态码状态码说明200成功400请求参数错误如未上传图片、图片无法解码500服务端检测异常三、接口列表3.1 健康检查用于探测服务是否存活不涉及图片与业务逻辑。请求项目说明方法GET路径/health请求体无响应状态码说明200服务正常响应体示例{status:ok}调用示例curl-XGET http://127.0.0.1:5000/health3.2 仅返回识别结果不返回图片上传一张图片返回手部检测结果JSON不包含标注图。适合只需结构化结果的场景。请求项目说明方法POST路径/detectContent-Type见下方两种方式二选一方式一表单上传图片文件Content-Type: multipart/form-data表单字段名必须为image值为图片文件如 .jpg、.png方式二JSON 传 Base64 图片Content-Type: application/json请求体为 JSON且包含以下字段之一image_base64图片的 Base64 编码字符串imageBase64同上兼容驼峰命名Base64 可带data:image/jpeg;base64,等前缀服务会自动截取逗号后的内容解码响应成功 200data结构字段类型说明summarystring[]简短结果摘要如[美甲: 85.0% [稳定], 手部完整: 90.0% [稳定]]detectionsobject[]检测项列表每项见下表hand_countnumber检测到的手的数量0 或 1 等detections 每项字段字段类型说明typestring类型标识见「识别类型枚举」class_namestring中文名称confidencenumber置信度 0~1boxnumber[] | null可选边界框 [x1, y1, x2, y2]像素坐标响应体示例成功{success:true,message:检测成功,data:{summary:[美甲: 85.0% [稳定],手部完整: 90.0% [稳定]],detections:[{type:nail_art,class_name:美甲,confidence:0.85,box:[120,200,180,260]},{type:normal,class_name:手部完整,confidence:0.9,box:[80,100,400,480]}],hand_count:1}}响应体示例失败 400{success:false,message:请上传图片 (字段名 image),data:null}调用示例# 表单上传文件curl-XPOST http://127.0.0.1:5000/detect-Fimage/path/to/photo.jpg# JSON Base64将 YOUR_BASE64_STRING 替换为实际 Base64curl-XPOST http://127.0.0.1:5000/detect\-HContent-Type: application/json\-d{image_base64:YOUR_BASE64_STRING}3.3 返回识别结果 标注图Base64上传一张图片返回识别结果的同时返回一张在图上画好检测框与文字的标注图JPEG以 Base64 形式放在data.image_base64。适合需要“原图结果图”的场景。请求与3.2 仅返回识别结果完全一致仅路径不同。项目说明方法POST路径/detect_imageContent-Typemultipart/form-data字段image或application/json字段image_base64/imageBase64响应成功 200data在 3.2 的基础上多一个字段字段类型说明summarystring[]同 3.2detectionsobject[]同 3.2hand_countnumber同 3.2image_base64string标注后的图片JPEG的 Base64 编码可直接用于展示或保存为 .jpg响应体示例成功仅摘录 data{success:true,message:检测成功,data:{summary:[美甲: 85.0% [稳定]],detections:[{type:nail_art,class_name:美甲,confidence:0.85,box:[120,200,180,260]}],hand_count:1,image_base64:/9j/4AAQSkZJRgABAQEASABIAAD/2wBD...}}前端使用示例将返回的 base64 显示为图片imgsrcdata:image/jpeg;base64,{{ data.image_base64 }}/调用示例curl-XPOST http://127.0.0.1:5000/detect_image-Fimage/path/to/photo.jpg四、识别类型枚举检测结果中的type与class_name对应关系如下typeclass_namenormal手部完整nail_art美甲wound手部伤口ring佩戴戒指long_nail长指甲fungal_nail灰指甲同一张图中可能同时返回多项如既有normal也有nail_art以实际检测为准。五、常见错误 messagemessage原因处理建议请上传图片 (字段名 image)使用 multipart 时未带image或文件为空检查表单字段名为image且选择了文件请提供 image_base64使用 JSON 时未传 base64 字段使用image_base64或imageBase64无法解码图片 / Base64 图片解码失败图片损坏或非图片格式确认为合法 jpg/png 等Base64 解码失败Base64 字符串非法检查编码是否正确、无换行/空格截断请使用 multipart/form-data (image 文件) 或 application/json (image_base64)Content-Type 既不是表单也不是 JSON按文档使用两种方式之一检测异常: xxx服务端推理出错查看服务端日志确认图片尺寸/格式合理六、附录接口速览方法路径说明GET/health健康检查POST/detect上传图片仅返回识别结果JSONPOST/detect_image上传图片返回识别结果 标注图 Base64所有 POST 接口的图片输入方式表单字段image或JSON 字段image_base64/imageBase64。
