接入与登录
能力矩阵
请先保存服务令牌。
筛选:
| 能力 | 说明 | 状态 | taskType |
|---|
场景包
调用方传 scene 走有序流水线;标准结果含 decision / grade / findings。Account API:/riskvision/api/v1/check。
| scene | 流水线 | 说明 |
|---|---|---|
UGC_IMAGE | detect → 1vn → nsfw → violence → ocr | IM/动态发图 |
AVATAR / GROUP_ICON | detect → quality → 1vn → nsfw | 头像 / 群图标 |
POLITICS_ONLY | face_compare_1vn | 对齐原 FACE_POLITICS |
KYC_FACE | detect → quality → liveness → 1v1 | 需 imageUrl2 |
COVER_ARTICLE / STICKER | detect → 1vn → … | 封面 / 表情 |
LIVE_FRAME | detect → 1vn | 建议异步 |
CUSTOM | capabilities[] | 自选顺序 |
标准 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": [] }
}