讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

SoundView
SoundView

字幕擦除翻译、配音口型同步

Seko
Seko

AI短剧一键生成成片

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
目录

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

相关专题

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

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

0

2026.11.17

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

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

0

2026.11.17

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

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

0

2026.11.17

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

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

0

2026.11.17

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

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

0

2026.11.17

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

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

0

2026.11.17

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

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

0

2026.11.12

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

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

0

2026.11.12

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

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

0

2026.11.12

热门下载

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

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn