Vision 能力台

InsightFace 能力台

列出本 Worker 已具备、需加模型、需外接的全部能力;已具备项可上传试跑。政治人物风控语义仍走运维台测图 / /v1/infer。

接入与登录

未登录

能力矩阵

请先保存服务令牌。

场景包

调用方传 scene 走有序流水线;标准结果含 decision / grade / findings。Account API:/riskvision/api/v1/check。

scene流水线说明
UGC_IMAGEdetect → 1vn → nsfw → violence → ocrIM/动态发图
AVATAR / GROUP_ICONdetect → quality → 1vn → nsfw头像 / 群图标
POLITICS_ONLYface_compare_1vn对齐原 FACE_POLITICS
KYC_FACEdetect → quality → liveness → 1v1需 imageUrl2
COVER_ARTICLE / STICKERdetect → 1vn → …封面 / 表情
LIVE_FRAMEdetect → 1vn建议异步
CUSTOMcapabilities[]自选顺序
标准 VisionCheckResult 摘要
{
  "checkId": "vc_…", "scene": "UGC_IMAGE",
  "decision": "PASS|REVIEW|BLOCK|SKIP", "grade": "L0..L4", "score": 0,
  "categories": [{ "code": "politics_figures", "score": 92, "severity": "high", "hit": true }],
  "findings": [{ "capabilityId": "face_compare_1vn", "status": "ok|skipped", "reason": "", "score": 92 }]
}

试跑工作台

请先保存服务令牌。

对接说明

管理台试跑与正式 API 共用统一响应形状;风控业务分仍可用 /v1/infer。

API 与 taskType 映射
加载后显示…
curl 示例
TOKEN=你的服务令牌
BASE=http://127.0.0.1:8191

# 能力列表
curl -sH "Token: $TOKEN" "$BASE/admin/api/capabilities" | jq .

# 管理台试跑(检测)
curl -sH "Token: $TOKEN" -F file=@face.jpg \
  "$BASE/admin/api/capabilities/run?capabilityId=face_detect" | jq .

# Worker 原子能力
curl -sH "Token: $TOKEN" -H "Content-Type: application/json" \
  -d '{"taskType":"FACE_DETECT","imageUrl":"https://example.com/a.jpg"}' \
  "$BASE/v1/analyze" | jq .

# Account 场景检测(同步)
curl -sH "Token: $TOKEN" -H "Content-Type: application/json" \
  -d '{"scene":"POLITICS_ONLY","imageUrl":"https://example.com/a.jpg"}' \
  "https://account/riskvision/api/v1/check" | jq .

# 异步 + 查询
curl -sH "Token: $TOKEN" -H "Content-Type: application/json" \
  -d '{"scene":"UGC_IMAGE","imageUrl":"https://example.com/a.jpg","callbackUrl":"https://biz/hook"}' \
  "https://account/riskvision/api/v1/check/async" | jq .
curl -sH "Token: $TOKEN" "https://account/riskvision/api/v1/check/{checkId}" | jq .

# 政治人物风控(原路径)
curl -sH "Token: $TOKEN" -H "Content-Type: application/json" \
  -d '{"taskType":"FACE_POLITICS","imageUrl":"https://example.com/a.jpg"}' \
  "$BASE/v1/infer" | jq .
Worker 原子响应字段
{
  "capabilityId": "face_detect",
  "ok": true,
  "skipped": false,
  "reason": "",
  "faceCount": 1,
  "faces": [{ "bbox": [], "detScore": 0.99, "kps": [], "sex": null, "age": null }],
  "embedding": { "dim": 512, "preview": [], "norm": 1.0 },
  "compare": { "similarity": 0.72, "matched": false },
  "galleryHit": { "code": "xdd", "similarity": 0.81 },
  "viz": { "boxes": [], "landmarks": [] }
}