
本人確認パイプライン
KYC やオンボーディングのサービスは、本人確認ワークフローから API を呼び出し、提出された ID の写真が公開 Web 上の他の写真と同一人物かを確認します。
FaceSearch REST API は、開発者に小さく安定した逆顔画像検索のインターフェースを提供します。写真を送信し、完了をポーリングし、結果を受け取るだけ。Bearer トークン認証、冪等リトライ、公開 OpenAPI 仕様を備えています。
エンドポイントは 1 つ • 検索ごとに 3 クレジット • すべて JSON
世界中の数千人から信頼されています
空のターミナルから最初の検索結果までわずか 3 ステップ。

ダッシュボードにログインしてキーを発行します。平文は 1 度だけ表示されます。シークレットマネージャーに保存し、ソースコードには決してコミットしないでください。

Bearer ヘッダーを付けて curl -F [email protected] https://facesearch.net/api/v1/search を実行します。エンドポイントは 1 秒以内に jobId を返します。

3〜5 秒ごとに GET /api/v1/search/{jobId} を呼び出します。ステータスが completed になると、一致したソース URL、サムネイル、信頼度スコアがレスポンスに含まれます。
本番バックエンドに顔検索を組み込むために必要なすべて。

本番バックエンドに顔検索を組み込むために必要なすべて。
/api/v1/openapi.json に手書きの OpenAPI ドキュメントを用意しており、Postman へのインポートから 20 以上の言語向けに生成されるクライアントまで、あらゆる型安全 SDK を支えます。
RFC 9110 準拠の Idempotency-Key ヘッダーを送信すれば、重複する送信に対して同じ jobId が返ります。ヘッダーを省略した場合でも、サーバーが自動でコンテンツハッシュを算出するため、素朴なリトライでも常に安全です。
各 API キーには日次・月次の上限を任意に設定できます。漏洩したキーで残高全体を使い切られることはなく、クォータは Redis の速度で、Postgres のフォールバックとともに適用されます。
すべてのレスポンスに X-RateLimit-Remaining と X-RateLimit-Reset ヘッダーを含みます。429 レスポンスには Retry-After が付くので、いつ再試行すべきかが一目で分かります。
API 利用は Web UI と同じクレジット残高から消費されます。ダッシュボードで 1 度チャージすれば両面で使え、新たな課金 SKU を管理する必要はありません。
すべてのエラーレスポンスは code、message、status の安定したエンベロープ形式です。INSUFFICIENT_CREDITS や RATE_LIMITED といったコードは変わらないので、エラー処理はシンプルなまま長く使えます。
FaceSearch の API 呼び出しはすべて 1 つの HTTP リクエストです。同じ「顔検索を送信する」フローを 5 つの言語で示します。
# 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"バックグラウンド調査から安全ツールまで、大規模な顔検索を必要とするチームを支えています。

KYC やオンボーディングのサービスは、本人確認ワークフローから API を呼び出し、提出された ID の写真が公開 Web 上の他の写真と同一人物かを確認します。

信頼と安全チームは API をインシデント対応パイプラインに接続し、エスカレーションされたユーザー通報を数時間ではなく数秒で文脈補完します。

調査報道記者や OSINT リサーチャーは Jupyter ノートブックから一括顔検索をスクリプト化し、冪等キーヘッダーで夜間バッチの重複を排除します。
FaceSearch を本番ワークフローに組み込んだチームからの実際のフィードバック。
"ハイブリッドな冪等キーの仕様は、私が見てきた API の中で一番良くできています。素朴なリトライはそのまま動きますし、新しい検索が必要なときは明示的なキーで完全にコントロールできます。"
"FaceSearch を午後だけでモデレーションパイプラインに組み込みました。キー単位のクォータのおかげで、誰かが誤って残高を使い切る心配なしに各チームへ専用キーを渡せます。"
"OpenAPI 仕様のおかげで、1 コマンドで型付きの Python クライアントを生成できました。エラーコードが変わらないので、パイプラインは良い意味で何か月も退屈なままです。"
ニーズに合ったプランを選択してください。隠れた料金はなく、いつでもキャンセルできます。
プロフェッショナルおよびパワーユーザー向け
Starter
$6
$2.00/credit
Basic
$24
$0.80/credit
Standard
$69
$0.69/credit
Pro
$199
$0.66/credit
Enterprise
$599
$0.60/credit
最初のリクエストを書く前に開発者が必ず聞くこと。
無料の API キーを作成し、curl のワンライナーを貼り付ければ、10 分以内に初回の検索を実行できます。
No credit card required