API 作为服务

人脸搜索, 直接从你的代码调用。

与网页版相同的引擎。REST 端点、X-API-Key 认证,一秒钟内 JSON 返回到你的收件箱。按月付费购买积分,随时充值,随时取消。

terminal · cURL

1$ curl -X POST https://api-v2.facesearchai.com/api/v1/api-service/search \
2    -H "X-API-Key: $FSAI_KEY" \
3    -F "file=@photo.jpg"
4
5→ 200 OK · 8 matches · 49 credits left

端点

五条路由。就是整个 API。

将你的密钥放在 X-API-Key头部发送。基础 URL 为 https://api-v2.facesearchai.com.

POST/api/v1/api-service/search执行反向人脸搜索。支持 multipart 文件或图像 URL。消耗 1 个积分。核心

GET/api/v1/api-service/keys列出你的 API 密钥及当前积分余额(不会返回任何 secret)。

POST/api/v1/api-service/keys生成新的 API 密钥。每个账户最多一个活动密钥。

DEL/api/v1/api-service/keys/{id}撤销一个活动密钥。立即生效。

POST/api/v1/api-service/checkout启动 Stripe 结账以订阅 API 计划。

响应

一种可预期的 JSON 结构。

每次搜索都会返回匹配项、积分余额,以及可以传回给你用户的 share id。

response.json · 200 OK

{
  "status": "success",
  "results_count": 8,
  "share_id": "qx7-9fa2",
  "credits_remaining": 49,
  "results": [
    {
      "url": "https://example.com/profile/42",
      "image_url": "https://cdn.example.com/p/42.jpg",
      "score": 0.9421,
      "source": "public-web"
    }
    /* ... 7 more */
  ]
}

价格

按积分计费,无合同。

订阅月度积分,不够时充值。订阅期间充值的积分不会过期。

月度

API Starter

$50/ 月

100 API 积分 / 月

每月 100 次人脸搜索
X-API-Key 认证,JSON 响应
每分钟 60 次请求
随时取消

充值包

$20一次性

40 额外积分 · $0.50/次搜索

40 个额外 API 积分
加入你现有的余额
在月度积分之后消耗
需要有效的订阅

充值积分

运作方式

到第一次匹配只需三步。

步骤 01

生成密钥

每个账户一个活动密钥。在仪表板中创建,并且只对你显示一次。请将其保存在密钥管理器中。

步骤 03

搜索

POST 一张图片,拿到 JSON。积分自动扣减。与网页搜索使用同一引擎,同样的响应结构。

Enterprise

定制用量,专属配额。

如果你需要更高的速率限制、私有化部署、签署 DPA、SLA 或批量折扣,请联系我们。我们与调查人员、记者、市场平台以及信任与安全团队合作。

更高的速率限制和定制配额
签署的 DPA 和安全审查
VPC / 私有化部署选项
定制 SLA 与专属支持
积分和充值的批量折扣

本页由 AI 自动翻译，原文以英文为准。EN →