THE VOICE TRUST API

From audio
to understanding.

A structured signal for your contact center workflow. Explore the request, understand the response, and try the contract.

Prototype documentation

All responses are simulated. You can explore the interface without an API key or audio detection service.

POST/detectContent-Type: application/json
01 / THE INPUT

A conversation, in context.

The prototype accepts one of three sample identifiers. The example recording convention is 8,000 Hz, two-channel PCM audio: caller on channel 0, agent on channel 1.

REQUEST · POST /detect
{  "audio": {    "source": "sample",    "sample_id": "voice-clone",    "sample_rate_hz": 8000,    "channels": 2  },  "channel_map": {    "caller": 0,    "agent": 1  },  "include": [    "acoustic",    "behavioral",    "semantic"  ]}

Sample IDs: voice-clone, human-caller, and noisy-call. This console does not upload audio.

02 / THE OUTPUT

A verdict you can inspect.

Every response includes the caller assessment and its layer states. Inconclusive evidence returns null, rather than implying the voice is human.

FieldTypeMeaning
verdictstringsynthetic, human, or inconclusive
is_syntheticboolean | nullnull when the example is inconclusive
confidencenumber | null0–1 confidence for the selected class
confidence_labelstring | nullThe class that the confidence describes
latency_msnumber | nullIllustrative acoustic-window latency
layersobjectAcoustic, behavioral, and semantic states
modestringAlways simulated in this prototype
200 · SIMULATED RESPONSE
{  "request_id": "demo-vio-024",  "mode": "simulated",  "subject_channel": 0,  "verdict": "synthetic",  "is_synthetic": true,  "confidence": 0.972,  "confidence_label": "synthetic",  "latency_ms": 412,  "latency_scope": "illustrative_acoustic_window",  "layers": {    "acoustic": {      "status": "flagged"    },    "behavioral": {      "status": "flagged"    },    "semantic": {      "status": "inconclusive"    }  }}
Latency describes an illustrative acoustic window. It is not a measured end-to-end response time.
03 / WHEN SOMETHING NEEDS ATTENTION

Clear errors. A way forward.

400
INVALID_JSON

Check quotes, commas, and brackets.

404
SAMPLE_NOT_FOUND

Use one of the three available sample IDs.

422
INVALID_REQUEST

Restore the example’s audio format, channel map, and layer list.

504
DEMO_TIMEOUT

Turn off “Simulate timeout” and send the request again.

04 / TRY IT YOURSELF

Meet the contract.

Edit the sample, preview a response, or explore a failure state. The entire console runs as a local demonstration.

Mock request console
LOCAL SIMULATION
Your response will appear here.

Edit the example and send a mock request.

Nothing is sent to a server. The console returns predefined examples.
SEE THE OTHER SIDE

Explore the call inspector.

Launch terminal