Phoneme & Classification

Synchronous classifier for an isolated French fricative recording (6 classes: f, s, v, z, ʃ, ʒ), built for the Aphasi…

post/api/classify-french-fricative

Request

  • Base URL: https://platform.vocametrix.com
  • URL: https://platform.vocametrix.com/api/classify-french-fricative
  • Auth: API key in header X-API-Key

Request body

audiostring required

Mode 1 (use ONE of audio/blobUrl/fileId). Direct audio file upload, multipart/form-data — the field name MUST be exactly audio.

blobUrlstring required

Mode 2 (use ONE of audio/blobUrl/fileId), JSON body. HTTPS URL of the audio file, downloaded server-side.

fileIdstring required

Mode 3 (use ONE of audio/blobUrl/fileId), JSON body. fileId from a prior /api/assignFileId upload.

expected_fricativestring

Optional (also accepted as expectedFricative, any input mode). When provided, the response is scored against this fricative.

Response

Successful response

successboolean

Boolean — true if the classification succeeded.

predicted_fricativestring

Predicted fricative (IPA).

confidencestring

Confidence for the predicted fricative (0.0 - 1.0).

all_probabilitiesobject

Object of probabilities for all 6 fricatives.

audio_durationnumber

Audio duration in seconds.

processing_time_secondsnumber

Server-side processing time in seconds.

model_namestring

Model used, e.g. "fricative-aphasix-champion".

expected_fricative (conditional)string

Echoed back only when expected_fricative/expectedFricative was provided in the request.

is_correct (conditional)boolean

Boolean — true when predicted_fricative matches expected_fricative.

expected_fricative_probability (conditional)string

The model's probability for expected_fricative, from all_probabilities.

score (conditional)integer

expected_fricative_probability rounded to a 0-100 integer.

Changes

No recorded changes to this operation across all 1 revision of this API.