Speaker enrollment and verification

curl https://platform.detectif.ai/v1/speakers/enroll \
  -H "Authorization: Bearer $DETECTIF_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F "speaker_id=customer-1042" \
  -F "display_name=Customer 1042" \
  -F "file=@enrollment-1.wav"

import os
import uuid
import requests

API = "https://platform.detectif.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['DETECTIF_API_KEY']}"}

def enroll(speaker_id: str, path: str, display_name: str | None = None) -> dict:
    fields = {"speaker_id": speaker_id}
    if display_name:
        fields["display_name"] = display_name
    with open(path, "rb") as f:
        resp = requests.post(
            f"{API}/speakers/enroll",
            headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
            data=fields,
            files={"file": (os.path.basename(path), f)},
            timeout=120,
        )
    body = resp.json()
    if not resp.ok:
        raise RuntimeError(f"{body['error']['code']}: {body['error']['message']} ({body['request_id']})")
    return body

body = enroll("customer-1042", "enrollment-1.wav", "Customer 1042")
print(body["speaker"]["samples"], body["quality"]["speech_seconds"])

import { readFile } from "node:fs/promises";
import { basename } from "node:path";
import { randomUUID } from "node:crypto";

const API = "https://platform.detectif.ai/v1";

async function enroll(speakerId, path, displayName) {
  const form = new FormData();
  form.append("speaker_id", speakerId);
  if (displayName) form.append("display_name", displayName);
  form.append("file", new Blob([await readFile(path)]), basename(path));
  const res = await fetch(`${API}/speakers/enroll`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.DETECTIF_API_KEY}`,
      "Idempotency-Key": randomUUID(),
    },
    body: form,
  });
  const body = await res.json();
  if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message} (${body.request_id})`);
  return body;
}

const body = await enroll("customer-1042", "enrollment-1.wav", "Customer 1042");
console.log(body.speaker.samples, body.quality.speech_seconds);

curl https://platform.detectif.ai/v1/speakers/verify \
  -H "Authorization: Bearer $DETECTIF_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F "speaker_id=customer-1042" \
  -F "detect_deepfake=true" \
  -F "file=@caller.wav"

import os
import uuid
import requests

def verify(speaker_id: str, path: str, detect_deepfake: bool = False) -> dict:
    fields = {"speaker_id": speaker_id}
    if detect_deepfake:
        fields["detect_deepfake"] = "true"
    with open(path, "rb") as f:
        resp = requests.post(
            "https://platform.detectif.ai/v1/speakers/verify",
            headers={
                "Authorization": f"Bearer {os.environ['DETECTIF_API_KEY']}",
                "Idempotency-Key": str(uuid.uuid4()),
            },
            data=fields,
            files={"file": (os.path.basename(path), f)},
            timeout=120,
        )
    body = resp.json()
    if not resp.ok:
        raise RuntimeError(f"{body['error']['code']}: {body['error']['message']} ({body['request_id']})")
    return body

body = verify("customer-1042", "caller.wav", detect_deepfake=True)
r = body["result"]
print(f"{r['decision']} similarity={r['similarity']:.3f} threshold={r['threshold']}")
df = body["deepfake"]
if df and "error" in df:
    print("deepfake check failed:", df["error"]["code"])
elif df:
    print("deepfake:", df["label"], df["score"])
print("charged:", body["credits"]["charged"])

import { readFile } from "node:fs/promises";
import { basename } from "node:path";
import { randomUUID } from "node:crypto";

async function verify(speakerId, path, detectDeepfake = false) {
  const form = new FormData();
  form.append("speaker_id", speakerId);
  if (detectDeepfake) form.append("detect_deepfake", "true");
  form.append("file", new Blob([await readFile(path)]), basename(path));
  const res = await fetch("https://platform.detectif.ai/v1/speakers/verify", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.DETECTIF_API_KEY}`,
      "Idempotency-Key": randomUUID(),
    },
    body: form,
  });
  const body = await res.json();
  if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message} (${body.request_id})`);
  return body;
}

const body = await verify("customer-1042", "caller.wav", true);
const r = body.result;
console.log(`${r.decision} similarity=${r.similarity.toFixed(3)} threshold=${r.threshold}`);
if (body.deepfake?.error) console.log("deepfake check failed:", body.deepfake.error.code);
else if (body.deepfake) console.log("deepfake:", body.deepfake.label, body.deepfake.score);
console.log("charged:", body.credits.charged);

# List speakers, 50 at a time
curl "https://platform.detectif.ai/v1/speakers?limit=50" \
  -H "Authorization: Bearer $DETECTIF_API_KEY"

# Read one speaker
curl https://platform.detectif.ai/v1/speakers/customer-1042 \
  -H "Authorization: Bearer $DETECTIF_API_KEY"

# Delete a speaker and its stored voice embeddings
curl -X DELETE https://platform.detectif.ai/v1/speakers/customer-1042 \
  -H "Authorization: Bearer $DETECTIF_API_KEY"

import os
import requests

API = "https://platform.detectif.ai/v1"
session = requests.Session()
session.headers["Authorization"] = f"Bearer {os.environ['DETECTIF_API_KEY']}"

def all_speakers():
    cursor = None
    while True:
        params = {"limit": 50}
        if cursor:
            params["cursor"] = cursor
        page = session.get(f"{API}/speakers", params=params, timeout=30).json()
        yield from page["data"]
        cursor = page.get("next_cursor")
        if not cursor:
            break

for speaker in all_speakers():
    print(speaker["speaker_id"], speaker["samples"])

print(session.get(f"{API}/speakers/customer-1042", timeout=30).json())
resp = session.delete(f"{API}/speakers/customer-1042", timeout=30)
print(resp.status_code)

const API = "https://platform.detectif.ai/v1";
const headers = { Authorization: `Bearer ${process.env.DETECTIF_API_KEY}` };

async function* allSpeakers() {
  let cursor;
  do {
    const url = new URL(`${API}/speakers`);
    url.searchParams.set("limit", "50");
    if (cursor) url.searchParams.set("cursor", cursor);
    const page = await (await fetch(url, { headers })).json();
    yield* page.data;
    cursor = page.next_cursor;
  } while (cursor);
}

for await (const speaker of allSpeakers()) console.log(speaker.speaker_id, speaker.samples);

console.log(await (await fetch(`${API}/speakers/customer-1042`, { headers })).json());
const del = await fetch(`${API}/speakers/customer-1042`, { method: "DELETE", headers });
console.log(del.status);