Didit Face Match

Polar Sponsor
爱发电 赞助
.NET 9.0

集成Didit Face Match独立API以比对两张面部图像。适用于用户需要比对面部、验证身份或实现生物识别的场景。

Didit Face Match API.

功能概述

Didit Face Match API.是一项面向实际任务的技能,主要用于Overview. compare 两种面部图像以确定它们是否属于同一人.;Return a commonity country country (0-100).;

核心要点

  • Key 约束:1. 支持格式: JPEG, PNG, WebP, T。
  • 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
  • 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。

使用与执行

从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。

Didit 人脸匹配 API

概述

比对两张人脸图像,判断是否属于同一人,并返回相似度得分(0–100)。

关键限制:

  • 支持格式:JPEG、PNG、WebP、TIFF
  • 单张图片最大文件大小:5MB
  • 若图像中包含多张人脸,则使用面积最大的人脸进行比对
  • user_image 和 ref_image 均为必填项

能力特性:相似度评分、年龄估计、性别检测、人脸边界框(bounding box)、可配置的拒绝阈值(decline threshold)、对非正向人脸的可选图像旋转支持。

API 参考文档: https://docs.didit.me/standalone-apis/face-match 功能指南: https://docs.didit.me/core-technology/face-match/overview

身份认证

所有请求均需携带 x-api-key 请求头。您可在 Didit 商户控制台 → API & Webhooks 中获取密钥,或通过程序化注册方式获取(见下文)。

快速开始(尚未注册账号?)

若您尚未拥有 Didit API 密钥,可通过 2 次 API 调用完成创建:

  1. 注册: 向 POST https://apx.didit.me/auth/v2/programmatic/register/ 发送请求,请求体为 {"email": "you@gmail.com", "password": "MyStr0ng!Pass"}
  2. 查收邮箱,获取 6 位一次性验证码(OTP)
  3. 验证: 向 POST https://apx.didit.me/auth/v2/programmatic/verify-email/ 发送请求,请求体为 {"email": "you@gmail.com", "code": "A3K9F2"} → 响应中将包含 api_key

充值操作: 使用 GET /v3/billing/balance/ 查询余额;使用 POST /v3/billing/top-up/ 并传入 {"amount_in_dollars": 50} 获取 Stripe 支付链接。

如需完整的平台管理能力(含工作流、会话、用户、账单等),请参考 didit-verification-management 技能。

接口地址

POST https://verification.didit.me/v3/face-match/

请求头(Headers)

请求头 值 是否必需
x-api-key 您的 API 密钥 是
Content-Type multipart/form-data 是

请求参数(multipart/form-data 格式)

参数名 类型 是否必需 默认值 约束条件 说明
user_image file 是 — JPEG/PNG/WebP/TIFF,最大 5MB 待验证用户的面部图像
ref_image file 是 — 同上 用于比对的参考图像
face_match_score_decline_threshold integer 否 30 取值范围:0–100 低于该值的得分为“拒绝”状态
rotate_image boolean 否 false — 尝试 0°/90°/180°/270° 旋转以定位正向人脸
save_api_request boolean 否 true — 保存至商户控制台“人工核查”列表中
vendor_data string 否 — — 您用于会话追踪的自定义标识符

调用示例

import requests

response = requests.post(
    "https://verification.didit.me/v3/face-match/",
    headers={"x-api-key": "YOUR_API_KEY"},
    files={
        "user_image": ("selfie.jpg", open("selfie.jpg", "rb"), "image/jpeg"),
        "ref_image": ("id_photo.jpg", open("id_photo.jpg", "rb"), "image/jpeg"),
    },
    data={"face_match_score_decline_threshold": "50"},
)
const formData = new FormData();
formData.append("user_image", selfieFile);
formData.append("ref_image", referenceFile);
formData.append("face_match_score_decline_threshold", "50");

const response = await fetch("https://verification.didit.me/v3/face-match/", {
  method: "POST",
  headers: { "x-api-key": "YOUR_API_KEY" },
  body: formData,
});

响应(200 OK)

{
  "request_id": "a1b2c3d4-...",
  "face_match": {
    "status": "Approved",
    "score": 80,
    "user_image": {
      "entities": [
        {"age": 27.63, "bbox": [40, 40, 100, 100], "confidence": 0.717, "gender": "male"}
      ],
      "best_angle": 0
    },
    "ref_image": {
      "entities": [
        {"age": 22.16, "bbox": [156, 234, 679, 898], "confidence": 0.717, "gender": "male"}
      ],
      "best_angle": 0
    },
    "warnings": []
  },
  "created_at": "2025-05-01T13:11:07.977806Z"
}

状态值及处理建议

状态 含义 建议操作
"Approved" 得分 ≥ 阈值 人脸匹配成功 — 可继续后续流程
"Declined" 得分 < 阈值,或未检测到人脸 检查 warnings 字段获取详情;可能需要质量更高的图像
"In Review" 需人工审核 等待审核结果,或通过会话 API 主动查询

错误响应

HTTP 状态码 含义 建议操作
400 请求非法 检查文件格式、大小及参数合法性
401 API 密钥无效 确认 x-api-key 请求头是否正确设置
403 账户余额不足 前往 business.didit.me 充值

响应字段说明

字段名 类型 说明
status string "Approved"、"Declined" 或 "In Review"
score integer 0–100 的相似度得分(越高表示越相似);若未检测到人脸则为 null
entities[].age float 估算年龄
entities[].bbox array 人脸边界框坐标 [x1, y1, x2, y2]
entities[].confidence float 人脸检测置信度(0–1)
entities[].gender string "male" 或 "female"
best_angle integer 使该人脸呈现最佳朝向所需的旋转角度(单位:度)
warnings array 警告对象数组,结构为 {risk, log_type, short_description, long_description}

警告标签说明

标签 说明 是否自动拒绝
NO_REFERENCE_IMAGE 缺少参考图像或人脸图像 是
NO_FACE_DETECTED 一张或两张图像中均未检测到人脸 是
LOW_FACE_MATCH_SIMILARITY 得分低于阈值 — 存在身份不一致风险 可配置

安全最佳实践:仅存储 status 和 score 字段;尽量避免在您自己的服务器上持久化生物特征图像数据。在工作流模式下返回的图像 URL 有效期为 60 分钟,过期后自动失效。

得分解读指南

得分区间 解读 建议操作
90–100 极高置信度 — 极大概率是同一人 自动通过
70–89 高置信度 — 很可能是同一人 通过(默认阈值为 30)
50–69 中等置信度 — 可能匹配 建议进入人工复核环节
30–49 低置信度 — 很可能不是同一人 按默认阈值被拒绝
0–29 极低置信度 — 基本可判定为不同人 拒绝

实用脚本

export DIDIT_API_KEY="your_api_key"

python scripts/match_faces.py selfie.jpg id_photo.jpg
python scripts/match_faces.py selfie.jpg id_photo.jpg --threshold 50 --rotate

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

0

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

0

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习