> **平台**: 万维易源 (ShowAPI)
> **接入方式**: 统一 API 网关 (HTTPS POST/GET)
> **认证**: showapi_appid + showapi_sign
> **文档**: https://www.showapi.com/apiGateway/view/2581/19
---
title: "动作行为识别 | 达摩院 | 人脸人体 | API 市场 | 万维易源"
canonical_url: "https://www.showapi.com/apiGateway/view/2581/19"
last_updated: "2026-08-26T04:37:46.827Z"
meta:
description: "可以识别视频和图像中的人体动作行为，并返回识别后的行为类别。当前可以识别的行为类别包括：举手、吃喝、吸烟、打电话、玩手机、趴桌睡觉、跌倒。您可以根据系统提供的动作置信度判断阈值，对识别的动作进行判断。阿里原接口订购地址：https://vision.aliyun.com/facebody
输入限制
视频要求：时长大于2秒；支持一些常见的视频格式，例如MPEG、AVI、MOV、MP4。
说明： 建议为居家摄像头或近距离监控场景。即摄像头固定不动，拍摄距离为2~10米之间。
图像要求：为2秒视频均匀采样的4张图像。支持的格式为JPEG、PNG、BMP、JPG。
分辨率：图像和视频的分辨率都要求为大于256×256像素，小于5000×5000像素。
URL地址中不能包含中文字符。"
keywords: showapi，万维易源，易源接口，api开放平台，开放api，api大全，api接口，接口中心，接口大全，开放平台，api，大数据，接口，API
"og:description": "可以识别视频和图像中的人体动作行为，并返回识别后的行为类别。当前可以识别的行为类别包括：举手、吃喝、吸烟、打电话、玩手机、趴桌睡觉、跌倒。您可以根据系统提供的动作置信度判断阈值，对识别的动作进行判断。阿里原接口订购地址：https://vision.aliyun.com/facebody
输入限制
视频要求：时长大于2秒；支持一些常见的视频格式，例如MPEG、AVI、MOV、MP4。
说明： 建议为居家摄像头或近距离监控场景。即摄像头固定不动，拍摄距离为2~10米之间。
图像要求：为2秒视频均匀采样的4张图像。支持的格式为JPEG、PNG、BMP、JPG。
分辨率：图像和视频的分辨率都要求为大于256×256像素，小于5000×5000像素。
URL地址中不能包含中文字符。"
"og:title": "动作行为识别 | 达摩院 | 人脸人体 | API 市场"
---
*
*
*
# **达摩院-人脸人体**
**连接器**
需两次购买：①订购原厂商接口 ②免费接口，注册后直接调用；为开发者和企业提供高性能的在线API服务，应用于人脸AR、人脸识别和认证、大规模人脸检索、照片管理等各种场景。
**免费****本接口注册后默认可免费调用，为防止滥用设有使用档次限制。**
[**了解积分与档位详情 › **](https://www.showapi.com/island/free-api)
权益档次可使用平台积分兑换更高调用档位，多种积分获取方式请查看积分与档位详情。
在线调试
**连接器服务**
免费接口，注册后直接调用
- 原厂商
- [达摩院___视觉智能开放平台](https://vision.aliyun.com/videoseg)
- 转发服务商
- 昆明秀派科技有限公司
- 电话
- 400-998-8033
- QQ
- 4009988033
- 邮箱
- [service@showapi.com](mailto:service@showapi.com)
- 所属分类
- IT技术
- 接入点
- 21 个
- 请求方式
- POST/GET
- 返回格式
- JSON
**动作行为识别**
接入点说明
```
可以识别视频和图像中的人体动作行为，并返回识别后的行为类别。当前可以识别的行为类别包括：举手、吃喝、吸烟、打电话、玩手机、趴桌睡觉、跌倒。您可以根据系统提供的动作置信度判断阈值，对识别的动作进行判断。阿里原接口订购地址：https://vision.aliyun.com/facebody
输入限制
视频要求：时长大于2秒；支持一些常见的视频格式，例如MPEG、AVI、MOV、MP4。
说明： 建议为居家摄像头或近距离监控场景。即摄像头固定不动，拍摄距离为2~10米之间。
图像要求：为2秒视频均匀采样的4张图像。支持的格式为JPEG、PNG、BMP、JPG。
分辨率：图像和视频的分辨率都要求为大于256×256像素，小于5000×5000像素。
URL地址中不能包含中文字符。
```
接口地址
https://connector.showapi.com/2581-19?appKey={your\_appKey} [查看密钥](https://www.showapi.com/console#/myApp) [调用帮助](https://www.showapi.com/helpcenter/view#/3960/1)
返回格式JSON
请求方式POST/GET
**请求参数**
**Header 参数**
| |
|
| |
|
**Post 表单**
| |
|
| |
|
| |
| |
| |
**返回参数**查看公共返回参数
该接口返回经 `showapi_res_body` 系统封装，业务数据均位于该对象内；系统级字段见公共返回参数。
**返回体**
| |
|
| |
|
| |
| |
| |
| |
| |
| |
| |
| |
| |
**请求示例**
[查看我的 appKey](https://www.showapi.com/console#/myApp) [查看使用向导](https://www.showapi.com/helpcenter/view#/3960/1) [Python / Java 等多语言示例](https://www.showapi.com/apitest/market/2581/19)
cURL 复制
```
curl -X POST "https://connector.showapi.com/2581-19?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "Type=0&VideoUrl=http%3A%2F%2Fshowapi-pub-shanghai.oss-cn-shanghai.aliyuncs.com%2Fapi%2F2581%2F2581-19.jpg&URL=&ds_id="
```
**返回示例**
JSON 复制
```
{
"showapi_res_error": "",
"showapi_res_code": 0,
"showapi_res_id": "5fc487d88d57ba442eece962",
"showapi_res_body": {
"Data": {
"Elements": [
{
"Boxes": [
{
"Box": [
1118,
609,
1407,
987
]
}
],
"Labels": [
"跌倒"
],
"Scores": [
0.66081887483597
],
"Timestamp": 3
},
{
"Boxes": [],
"Labels": [],
"Scores": [],
"Timestamp": 5
}
]
},
"ret_code": 0,
"remark": "请求成功",
"RequestId": "F70F76BE-1059-434A-BAA9-2C02A338CED3"
}
}
```
**MCP 服务集成**接口级
在 Cherry Studio、ChatBox 等支持 MCP 的客户端中配置，将 {your\_appKey} 替换为真实 AppKey（ [AppKey 管理](https://www.showapi.com/console#/myApp)）。该服务覆盖本接口全部接入点。
MCP JSON 复制
```
{
"mcpServers": {
"showapi-mcp-2581": {
"url": "http://www.showapi.com.cn/mcp/2581/{your_appKey}"
}
}
}
```
**OpenAPI 文档**接口级
标准 OpenAPI 3.0 文档，覆盖本接口全部接入点，可导入 Apifox / Postman / Swagger UI，或供 AI Agent 直接消费。
[在线查看 YAML](https://www.showapi.com/openapi/market/2581.yaml) [下载 YAML](https://www.showapi.com/openapi/market/2581.yaml) [查看 JSON](https://www.showapi.com/openapi/market/2581.json)