GetMediapipeEvent - 查询数据流事件详情--边缘智能-火山引擎

文档中心

立即注册

导航

GetMediapipeEvent - 查询数据流事件详情

最近更新时间：2025.04.22 15:34:59首次发布时间：2025.04.22 11:47:46

调用本接口查询指定数据流事件的详情。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	GetMediapipeEvent	要执行的操作，取值：GetMediapipeEvent。
Version	String	是	2022-01-01	API的版本，取值：2022-01-01。
event_id	String	是	64abec17e80495d102ac1c2e	要查询的数据流事件的ID。您可以调用ListMediapipeEvent接口获取所有数据流实例ID。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
event_id	String	64abec17e80495d102ac1c2e	数据流事件ID。
event_type	String		事件类型。
instance_id	String	mpi-2100053947-9dl8n	数据流实例ID。
instance_name	String	instanceA	数据流实例名称。
source_type	String	1	数据源类型。该参数有以下取值： 1：RTSP 拉流 2：摄像头设备 3：RTMP 拉流
source_id	String	source_id123	数据源ID。
project_id	String	p-2100001281-zf9ll	数据流实例所属边缘智能项目ID。
create_time	String		创建时间。
base64_image_string	String		图片帧对应的 base64 字符串。
json_all_string	String		json 格式的原始数据字符串。
obj_bboxes	Array of Object		对象属性。包含 bbox，label，置信度等。

请求示例

POST /?Action=GetMediapipeEvent&Version=2022-01-01 HTTP/1.1
Host: open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20250421T081510Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250421/cn-beijing/vei_api/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "event_id": "64abec17e80495d102ac1c2e"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20250421161544252200006034A90598",
    "Action": "GetMediapipeEvent",
    "Version": "2022-01-01",
    "Service": "vei_api",
    "Region": "cn-beijing"
  },
  "Result": {
    "event_id": "648ac6a9e2358b12d6ac714a",
    "event_type": "UserDefinedMediapipeEvent",
    "instance_id": "mediapipe_instance_id123456",
    "instance_name": "instance_name123456",
    "source_type": 2,
    "source_id": "source_id123456",
    "project_id": "project_id123456",
    "create_time": "1686470645",
    "base64_image_string": "123456",
    "json_all_string": "{\"source_id\":\"source_id123456\",\"project_id\":\"project_id123456\",\"mediapipe_instance_name\":\"instance_name123456\",\"mediapipe_instance_id\":\"mediapipe_instance_id123456\",\"source_type\":\"Device\"}"
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	600004	请求中Event ID为空	请求中Event ID为空。