Show your users exactly which wo /ɜː/ 51 00:01.544 — 00:01.620 Round lips slightly, tongue mid-height and centered rds words 72 Matched /wɜːdz/ 00:01.482 — 00:01.812 Phonemes w /w/84 o /ɜː/51 r /ɹ/78 ds /dz/74 need wor /ɔː/ 48 00:02.106 — 00:02.184 Round lips, tongue low and back k work 64 Matched /wɜːk/ 00:02.044 — 00:02.288 Phonemes w /w/76 or /ɔː/48 k /k/81 .

# Score a recording with curl
curl -X POST https://api.prosody.studio/v1/scores \
  -H "X-API-Key: $PROSODY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_data": "'$(base64 < recording.wav)'",
    "sample_rate": 16000,
    "language": "en-US",
    "reference_text": "The quick brown fox jumps over the lazy dog"
  }'

// TypeScript SDK
import { ProsodyClient } from "@prosody/sdk";

const client = new ProsodyClient({ apiKey: process.env.PROSODY_API_KEY });
const result = await client.score({
  audio: readFileSync("recording.wav").toString("base64"),
  language: "en-US",
  referenceText: "The quick brown fox jumps over the lazy dog"
});

# Score a recording with Python
import requests, base64

with open("recording.wav", "rb") as f:
    audio = base64.b64encode(f.read()).decode()

resp = requests.post(
    "https://api.prosody.studio/v1/scores",
    headers={"X-API-Key": PROSODY_API_KEY},
    json={
        "audio_data": audio,
        "sample_rate": 16000,
        "language": "en-US",
        "reference_text": "The quick brown fox jumps over the lazy dog",
    },
)
result = resp.json()

{
  "scores": {
    "pronunciation": 72.4,
    "script_adherence": 100.0,
    "overall": 72.4
  },
  "words": [
    {
      "word": "the",
      "status": "match",
      "acoustic_match": 68.1,
      "timing": { "start": 0.12, "end": 0.24, "duration_ms": 120 },
      "phonemes": [
        { "detected": "DH", "acoustic_match": 71.2, "timing": { "start": 0.12, "end": 0.18 } },
        { "detected": "AH", "acoustic_match": 65.0, "timing": { "start": 0.18, "end": 0.24 } }
      ]
    }
  ]
}