Sign in

v1

latestOpenAPI 3.0.32026-07-26229361630.0 KB
protocol

Upload Audio

Upload audio as a raw binary body. For single uploads (the default upload type), send one complete recording (max 10 MB) and the server performs Voice Activity Detection (VAD) chunking inline — for larger recordings use chunked uploads or the SDKs. For chunked uploads, call this repeatedly with sequentially numbered filenames (audio_0.webm, audio_1.webm, ...); the server stores each chunk by its sequence number. The audio content type is detected automatically from the file extension; set the Content-Type header only to override it.

post/voice/v1/sessions/{session_id}/audio/{file_sequence}

Path parameters

session_idstring required
Example:ses_abc123def456

Session ID returned by Create Session

file_sequencestring required
Example:audio_0.webm

Audio filename with a sequence number and extension: <base>_<sequence>.<ext>. For single uploads just use audio_0.webm; for chunked uploads increment the sequence per chunk (audio_0.webm, audio_1.webm, ...).

Headers

Content-Type'audio/webm;codecs=opus' | 'audio/mp3' | 'audio/wav' | 'audio/ogg' | 'audio/m4a' | 'audio/mp4'

Audio MIME type. Leave unset — the server detects it automatically from the file_sequence extension (.webm, .mp3, .wav, .ogg, .m4a, .mp4). Generic values like application/octet-stream are also auto-resolved from the extension.

Response

Audio uploaded successfully

session_idstring
successboolean
original_filenamestring

Example response

{
  "session_id": "ses_abc123def456",
  "success": true,
  "original_filename": "audio_0.webm"
}