Skip to main content
POST
Transcribe and redact PII/PHI from an audio file

Authorizations

X-API-Key
string
header
required

API key used for authentication and usage tracking.

Body

multipart/form-data
upload_file
file
required

Audio file to transcribe and redact. Supported formats: AAC, AIFF, FLAC, MP3, MP4, MOV, OGG, Opus, WAV, WebM. Maximum file size: 100MB. Empty files are rejected.

speaker_diarization
boolean
default:true

Speaker diarization identifies different speakers in the audio. When enabled, each utterance includes a speaker identifier (e.g., 1, 2).

start_redaction_padding_ms
integer
default:100

Additional silence in milliseconds to prepend before each redacted audio range. Extends the silenced region earlier in time to provide a buffer before PII/PHI content.

Required range: x >= 0
end_redaction_padding_ms
integer
default:0

Additional silence in milliseconds to append after each redacted audio range. Extends the silenced region later in time to provide a buffer after PII/PHI content.

Required range: x >= 0
language
string

Optional language hint as a case-insensitive ISO 639-1 code (e.g. "en", "fr"). BCP 47 region/script subtags (e.g. "en-US") are accepted; only the primary language subtag is used. When omitted, the language is detected automatically for each utterance.

Pattern: ^[A-Za-z]{2,3}([-_][A-Za-z0-9]+)*$

Response

Redaction completed successfully

metadata
object
audio
file

Redacted MP3 audio file with PII/PHI ranges silenced.