API文档 - 联网SOP

📋 API概览

联网SOP提供RESTful API接口，支持通过HTTP请求直接调用视频SOP检测功能。所有API返回JSON格式数据。

Base URL: https://wlwsop.74lee.com

🎯 视频SOP分析 POST

POST /api/analyze

提交视频URL、关注点和SOP流程进行AI分析，返回检测结果。

请求参数 (JSON Body)

参数	类型	必填	说明
`video_url`	string	✅	视频URL，支持 http/https/rtsp/rtmp
`watch_points`	string	❌	关注重点，不填则全面分析
`sop_flow`	string	✅	标准SOP流程描述
`template_type`	enum	❌	SUMMARY_ONLY / FRAME_ONLY / FRAME_AND_SUMMARY

返回结果

{
    "success": true,
    "record_id": "1681812345678",
    "answer": {
        "video_summary": "视频整体总结...",
        "judeg_res": "符合标准SOP流程...",
        "frame_info": [
            {
                "frame_time": "0.0s",
                "frame_url": "http://...",
                "description": "帧描述"
            }
        ]
    },
    "metadata": {
        "elapsed_seconds": 12.5,
        "usage": {
            "total_tokens": 37874
        }
    }
}
            

请求示例

curl -X POST https://wlwsop.74lee.com/api/analyze \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "http://example.com/video.mp4",
    "watch_points": "关注人员手部动作、发牌手法",
    "sop_flow": "第一步：发牌前展示手部\n第二步：开始发牌\n第三步：发牌结束展示手部",
    "template_type": "FRAME_AND_SUMMARY"
}'

📋 获取结果列表 GET

GET /api/results

获取所有检测记录列表。

            {
                "success": true,
                "count": 10,
                "results": [
                    {
                        "id": "1681812345678",
                        "timestamp": "2026-03-18 12:00:00",
                        "video_url": "http://...",
                        "watch_points": "...",
                        "sop_flow": "...",
                        "template_type": "FRAME_AND_SUMMARY",
                        "answer": { ... },
                        "metadata": { ... }
                    }
                ]
            }
        

🔍 获取单条结果 GET

GET /api/result/{record_id}

根据record_id获取单条检测结果。

🔧 在线测试 POST

POST /api/test

透传调用旷视视频摘要SOP智能体API，返回原始响应。
参数格式同 /api/analyze，返回未经解析的原始数据。

🏗️ 旷视原始API参考

本系统底层调用旷视视频摘要SOP智能体API，原始接口定义如下：

📚 原始请求参数 ▼

参数	说明
`agent_id`	固定值 ipu@megvii.com/cloud/video_summary_sop_1
`response_mode`	固定 "blocking"
`query`	拼接格式：${关注点}，请判断视频内容是否符合标准SOP流程：${标准SOP流程}
`inputs.template_type`	SUMMARY_ONLY / FRAME_ONLY / FRAME_AND_SUMMARY
`files[].type`	"video"
`files[].transfer_method`	"remote_url"
`files[].url`	视频URL地址

📚 原始返回字段 ▼

字段	说明
`answer.video_summary`	视频整体总结
`answer.judeg_res`	判断结果（是否符合SOP）
`answer.frame_info[]`	逐帧分析信息数组
`frame_info[].frame_time`	该帧在视频中的时间点
`frame_info[].frame_url`	该帧截图URL
`frame_info[].description`	该帧描述