Skip to main content

API Biometric Redaction Parameters


Example Curl Usage

✅ Minimal biometric redaction request (uses defaults)

curl -X POST https://voiceharbor.ai/api/speech-to-speech-biometric-redaction \
  -H "Authorization: Bearer YOUR_USAGE_TOKEN" \
  -F "source_audio=@./martin.wav;type=audio/wav" \
  --output result.wav

🎯 Custom biometric request

curl -X POST https://voiceharbor.ai/api/speech-to-speech-biometric-redaction \
  -H "Authorization: Bearer YOUR_USAGE_TOKEN" \
  -F "source_audio=@./martin.wav;type=audio/wav" \
  -F "model_id=advanced" \
  -F "biometric-age=same" \
  -F "gender=opposite" \
  -F "emotion=sad" \
  -F "language=fr" \
  --output redacted_fr.wav
biometric-age
string
default:"young-adult"
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
gender
string
default:"random"
Target gender of the anonymized voice identity. Allowed values:
  • same
  • opposite
  • random
  • f
  • m
language
string
default:"en"
Target language of the audio file. Allowed values:
  • en
  • fr
  • it
  • es
  • de
model_id
string
default:"mini"
Model variant for biometric voice print redaction. Allowed values:
  • mini 0.25 RTF
  • advanced 0.75 RTF
emotion
string
Optional emotion to apply to anonymised identity.
  • happy
  • default
  • sad

Audio Input Requirements

To ensure reliable processing and accurate biometric redaction, uploaded audio files must meet the following requirements.

Supported File Formats

Only the following audio formats are supported for I/O, Mono or Stereo:
  • WAV (.wav)

File Size Limits

  • Maximum file size: 10 MB per request
  • Files exceeding this limit will be rejected with a 413 Payload Too Large error.
If you need higher limits for enterprise use cases, please contact support.

Audio Duration Limits

  • Minimum duration: > 0 seconds
  • Maximum duration: 60 minutes (3600 seconds)
Files longer than 60 minutes are not accepted, even if they meet the file size limit.