Python SDK

pip install voicemark

from voicemark import VoiceMark

vm = VoiceMark(
    api_key="vmk_live_...",       # required
    base_url="https://api.voicemark.dev/v1",  # optional override
)

from voicemark import AsyncVoiceMark

async with AsyncVoiceMark(api_key="vmk_live_...") as vm:
    enrollment = await vm.enroll(audio_bytes, user_id="user_123")

from voicemark import VoiceMark, EnrollResponse

enrollment: EnrollResponse = vm.enroll(audio_bytes, user_id="user_123")
print(enrollment.voiceprint_id)   # store this — pass to verify()
print(enrollment.quality_score)   # 0–1 enrollment quality

@dataclass
class EnrollResponse:
    voiceprint_id: str
    enrolled_at: str           # ISO 8601
    quality_score: float       # 0–1
    duration_s: float
    glyph_params: dict[str, float]

challenge = vm.challenge()
print(challenge.phrase)        # show to user before recording
print(challenge.challenge_id)  # pass to verify()

@dataclass
class ChallengeResponse:
    phrase: str
    challenge_id: str
    expires_in: int            # seconds (default 300)
    source: ChallengeSource | None

from voicemark import VerifyResponse

result: VerifyResponse = vm.verify(
    audio_bytes,
    voiceprint_id=enrollment.voiceprint_id,  # identity check
    challenge_id=challenge.challenge_id,      # anti-replay
)

if result.authorized:
    # use result.token for downstream authorisation
    pass

@dataclass
class VerifyResponse:
    token: str                  # ephemeral JWT, 60 s TTL
    token_id: str
    authorized: bool
    pii: None
    expires_in: int             # seconds
    liveness_score: float | None
    transcription: str | None
    cloud_data: VerifyCloudData | None

check = vm.token(result.token_id, token_jwt=result.token)
print(check.valid)       # True / False
print(check.expires_in)  # seconds remaining

perm = vm.policy(result.token, "payment.authorise")
if perm.permitted:
    process_payment()

vm.receipt(
    result.token,
    "payment.authorise",
    "success",
    {"amount": 250, "currency": "GBP"},
)

from voicemark import VoiceMarkError

try:
    result = vm.verify(audio_bytes, voiceprint_id=stored_id)
except VoiceMarkError as e:
    print(e.code)     # "VOICE_MISMATCH" | "CHALLENGE_EXPIRED" | ...
    print(e.status)   # HTTP status code
    print(str(e))     # human-readable message

# sync
with VoiceMark(api_key="vmk_live_...") as vm:
    enrollment = vm.enroll(audio, user_id="user_1")

# async
async with AsyncVoiceMark(api_key="vmk_live_...") as vm:
    enrollment = await vm.enroll(audio, user_id="user_1")