金融科技
身份核验流水线
KYC 与开户服务在身份核验流程中调用 API，确认提交证件上的照片与公开网络上的其他照片一致。
FaceSearch REST API
用任何语言发起人脸搜索
FaceSearch REST API 为开发者提供了一套精简、稳定的反向人脸图像搜索接口：上传照片、轮询状态、获取结果。支持 Bearer 令牌鉴权、幂等重试和公开的 OpenAPI 规范。
一个端点 • 每次搜索 3 积分 • 全程 JSON
全球数千用户信赖
15,000+ 次搜索
50+ 个国家
256位加密
99.7% 准确率
REST API 工作原理
三步即可从空白终端跑出第一条搜索结果。
1
创建 API 密钥
登录控制台并生成密钥。明文仅显示一次，请妥善保存在密钥管理器中，切勿提交到代码仓库。
2
POST 上传图片
带上 Bearer 请求头执行 curl -F [email protected] https://facesearch.net/api/v1/search，接口会在一秒内返回 jobId。
3
轮询至完成
每隔 3 到 5 秒调用一次 GET /api/v1/search/{jobId}。状态变为 completed 后，响应会包含匹配的来源 URL、缩略图和置信度分数。
REST API 功能
将人脸搜索集成到生产后端所需的一切。
REST API 功能
将人脸搜索集成到生产后端所需的一切。
OpenAPI 3.1 规范
位于 /api/v1/openapi.json 的手写 OpenAPI 文档，可生成 20 多种语言的类型安全 SDK，也能直接导入 Postman。
幂等重试
发送 RFC 9110 Idempotency-Key 请求头，服务端对重复请求返回相同的 jobId。即便不传该头，服务端也会基于内容哈希自动去重，朴素的重试始终安全。
按密钥配额
每把 API 密钥都可设置可选的每日和每月上限。泄露的密钥无法掏空你的整个余额，配额由 Redis 高速执行，并有 Postgres 兜底。
精细的速率限制
每个响应都带有 X-RateLimit-Remaining 和 X-RateLimit-Reset 响应头。收到 429 时，Retry-After 会明确告知何时可以重试。
共享积分池
API 消耗与网页端共用同一积分池。在控制台充值一次即可同时驱动两端，无需维护新的计费 SKU。
可预期的错误
每个错误响应都是稳定的信封结构：code、message、status。INSUFFICIENT_CREDITS、RATE_LIMITED 等错误码永不变更，你的错误处理可以写得朴素而长久。
复制，粘贴，发布。
每一次 FaceSearch API 调用都是一次 HTTP 请求。以下是同一个“提交人脸搜索”流程在五种语言中的写法。
终端单行命令
# 1. Submit a face image for search
curl -X POST https://facesearch.net/api/v1/search \
-H "Authorization: Bearer fs_live_YOUR_KEY" \
-H "Idempotency-Key: submit-$(date +%s)" \
-F "image=@/path/to/face.jpg" \
-F "consent=true"
# 2. Poll for completion
curl https://facesearch.net/api/v1/search/JOB_ID \
-H "Authorization: Bearer fs_live_YOUR_KEY"
# 3. Check your credit balance
curl https://facesearch.net/api/v1/credits \
-H "Authorization: Bearer fs_live_YOUR_KEY"谁在基于 REST API 构建
从背景调查到安全工具，API 正在为大规模人脸搜索的团队提供动力。
安全
自动化内容审核
信任与安全团队将 API 接入事件响应流水线，升级的用户举报在几秒而不是几小时内便能补齐上下文。
研究
调查研究
调查记者与 OSINT 研究员在 Jupyter Notebook 中脚本化批量搜索，通过幂等键请求头对夜间批量任务进行去重。
值得信赖的人脸搜索平台
1000万+
已完成的搜索
全球值得信赖的结果
95%
匹配准确率
由先进人工智能驱动
5万+
活跃用户
不断增长的社区
1亿+
已扫描的来源
全面覆盖
开发者怎么评价这套 API
来自将 FaceSearch 接入生产工作流团队的真实反馈。
"这套混合幂等键策略是我见过最好的。朴素重试直接可用，而显式传入 key 也能让我们在需要全新搜索时拥有完全控制权。"
"我们一个下午就把 FaceSearch 接入了审核流水线。按密钥配额让我们能把不同密钥分给不同团队，完全不用担心谁会不小心把积分耗光。"
"OpenAPI 规范让我一行命令就生成了带类型的 Python 客户端。错误码从不变更，几个月来我的流水线一直稳定得让人心安。"
简单、透明的定价
选择适合您需求的计划。没有隐藏费用，随时可以取消。
最受欢迎
PRO
$29/月
适合专业人士和高级用户
- 100 Credits per month ($0.29 per credit)
- Face Search
- Search History
- Can Export Profile to PDF
按需付费
或购买积分包
Starter
3积分
$6
$2.00/credit
节省 20%
Basic
30积分
$24
$0.80/credit
节省 31%
Standard
100积分
$69
$0.69/credit
节省 34%
Pro
300积分
$199
$0.66/credit
节省 40%
Enterprise
1000积分
$599
$0.60/credit
REST API 常见问题
开发者在写出第一条请求前最常问的问题。
