Face Verification API
Check if a face belongs to a protected identity in milliseconds
Real-time Processing
Fast response times with high availability
JWT Authentication
Secure token-based authentication with rate limiting
REST API
Standard REST API with OpenAPI documentation at /docs
Quick Start
Python
from actorhub import ActorHub
client = ActorHub(api_key="your_api_key")
# Check if image contains protected identities
result = client.verify(image_url="https://example.com/face.jpg")
if result.protected:
print("⚠️ Protected identity detected!")
for identity in result.identities:
print(f" - {identity.display_name}")
if not identity.allow_commercial:
print(" Commercial use: NOT ALLOWED")
else:
print("✅ No protected identities - OK to generate")JavaScript
import { ActorHub } from '@actorhub/sdk';
const client = new ActorHub({ apiKey: 'your_api_key' });
// Check if image contains protected identities
const result = await client.verify({
imageUrl: 'https://example.com/face.jpg'
});
if (result.protected) {
console.log('⚠️ Protected identity detected!');
for (const identity of result.identities) {
console.log(` - ${identity.displayName}`);
}
} else {
console.log('✅ No protected identities - OK to generate');
}API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST | /v1/identity/verify | Verify a face against protected identities |
| GET | /v1/identity/{id} | Get identity details and permissions |
| POST | /v1/consent/check | Check consent status for AI generation |
| GET | /v1/marketplace/listings | Browse available Actor Packs |
| POST | /v1/actor-packs/train | Train a new Actor Pack (LoRA model) |
| GET | /v1/marketplace/licenses/mine | Get your purchased licenses |
| POST | /v1/marketplace/license/purchase | Purchase a license for an Actor Pack |