ActorHub Python SDK

Official Python client for the ActorHub.ai consent API.

ActorHub.ai is where real people become licensed AI talent: they verify who they are, set the terms their likeness may be used on, and brands license a verified person for a campaign. This SDK answers whether a face in an image belongs to a verified person and what that person agreed to, before anything is generated.

Installation

pip install actorhub

Quick Start

from actorhub import ActorHub

client = ActorHub(api_key="your-api-key")

# Check consent before AI generation
result = client.check_consent(
    platform="sora",
    intended_use="video",
    image_url="https://example.com/face.jpg",
)

if result.protected:
    face = result.faces[0]
    print(f"Verified person: {face.display_name}")
    print(f"Consent: {face.consent.video_generation}")
    
    # Check if active consent token exists
    if face.token and face.token.valid:
        print(f"Active token: {face.token.source}")
    
    # Verify trust signature
    if result.trust:
        print(f"Signed: {result.trust.algorithm}")

With Consent Token

result = client.check_consent(
    platform="sora",
    intended_use="video",
    image_url="https://example.com/face.jpg",
    consent_token="ACT-XXXX",  # Token from identity owner
)

Async Support

from actorhub import AsyncActorHub

async with AsyncActorHub(api_key="your-api-key") as client:
    result = await client.check_consent(
        platform="runway",
        intended_use="video",
        image_url="https://example.com/face.jpg",
    )

Links

• Documentation
• API Reference
• Website