Parameters
Biometric Redaction Parameters
Biometric age group to apply to the anonymized voice identity. Only used when
avatar
is not provided.
Allowed values:- young-adult (18–39)
- middle-aged-adult (40–59)
- senior-adult (60+)
- same
- random
Target gender of the anonymized voice identity.
Allowed values:
- same
- opposite
- random
- f
- m
Target language of the audio file.
Allowed values:
- en
- fr
- it
- es
- de
Model variant for biometric voice print redaction.
Allowed values:
- mini 0.25 RTF
- advanced 0.75 RTF
Optional emotion to apply to avatar identity.
Example Curl Usage
✅ Minimal biometric redaction request (uses defaults)
🎯 Custom biometric request
⚠️ Possible API Errors
HTTP Code | Error Condition | Message |
---|---|---|
400 | Invalid field value or combination (generic validation) | Descriptive error string |
400 | Missing required body field fileName or audio_duration | "Missing fileName or audio_duration" |
400 | audio_duration invalid / out of bounds (>0 and ≤3600) | "Invalid audio_duration" |
400 | Missing audio upload | "Missing audio file" |
400 | Multer rejected file by MIME/extension | "Invalid file type" |
400 | Magic-bytes audio check failed | "Invalid or unsupported audio format (magic check failed)" |
400 | Invalid model_id | "Invalid model_id. Allowed: mini, advanced" |
400 | Invalid language | "Invalid language. Allowed: en, fr, it, es, de" |
400 | Invalid biometric-age | "Invalid biometric-age. Allowed: young-adult, middle-aged-adult, senior-adult, same, random" |
400 | Invalid gender | "Invalid gender. Allowed: same, random, opposite, f, m" |
400 | Invalid emotion | "Invalid emotion. Allowed: sad, happy, default" |
401 | Missing or malformed Authorization header (general) | "Missing Authorization" |
401 | Missing or malformed Authorization header (proxy endpoint) | "Missing Authorization header" |
403 | Invalid developer/usage token | "Invalid token" |
403 | Invalid admin token (or expired/unsigned legacy admin token) | "Invalid admin token" |
403 | CORS rejection for disallowed browser Origin | { "error": "CORS" } |
413 | Uploaded file exceeds configured size | "File too large" |
429 | Rate limit exceeded | "Too many requests, please slow down" |
500 | DB failure | "Database error" |
500 | Proxy/upstream/network/timeout error | "Anonymisation failed" |
503 | Readiness DB check failed | { "ready": false } |