Pronunciation API Dokumentation

# pip install lingolix  (or: uv add lingolix)
from lingolix import Lingolix, QuotaExceededError

# WARNING: Keep API keys server-side only! Never expose in client-side code.
# Lingolix() reads $LINGOLIX_API_KEY. AsyncLingolix is the async twin.
with Lingolix() as client:
    try:
        # Bekannter-Text-Modus
        r = client.check("audio.wav", sentence="Guten Morgen", language="de")

        # Freies-Sprechen-Modus (sentence weggelassen)
        # r = client.check("audio.wav", language="de")

        print(r.overall, r.accuracy, r.fluency, r.speaking_rate)
        for word in r.words:
            for s in word.syllables:
                print(s.text, s.expected_ipa, "→", s.detected_ipa, s.pitch, round(s.accuracy, 2))
    except QuotaExceededError as e:
        print(f"{e.plan} plan is out of minutes — upgrade at {e.upgrade_url}")

{
  "text": "Guten Morgen",
  "overall": 0.81,
  "accuracy": 0.78,
  "fluency": 1,
  "completeness": 1,
  "speaking_rate": 4.4,
  "target_speaking_rate": 3,
  "model_version": "2026-10",
  "words": [
    {
      "text": "Guten",
      "syllables": [
        {
          "text": "Gu",
          "expected_ipa": "ɡuː",
          "detected_ipa": "ɡuː",
          "accuracy": 1,
          "completeness": 1,
          "pitch": "low",
          "duration_ms": 200,
          "start_ms": 300,
          "end_ms": 500,
          "is_missing": false,
          "is_extra": false
        },
        {
          "text": "ten",
          "expected_ipa": "tn̩",
          "detected_ipa": "tn̩",
          "accuracy": 1,
          "completeness": 1,
          "pitch": "high",
          "duration_ms": 200,
          "start_ms": 520,
          "end_ms": 720,
          "is_missing": false,
          "is_extra": false
        }
      ],
      "accuracy": 1,
      "completeness": 1,
      "start_ms": 300,
      "end_ms": 720,
      "char_start": 0,
      "char_end": 5,
      "hesitation_ms": null
    },
    {
      "text": "Morgen",
      "syllables": [
        {
          "text": "Mor",
          "expected_ipa": "mɔʁ",
          "detected_ipa": "ma",
          "accuracy": 0.33,
          "completeness": 0.67,
          "pitch": "high",
          "duration_ms": 200,
          "start_ms": 760,
          "end_ms": 960,
          "is_missing": false,
          "is_extra": false
        },
        {
          "text": "gen",
          "expected_ipa": "ɡn̩",
          "detected_ipa": "ɡn̩",
          "accuracy": 1,
          "completeness": 1,
          "pitch": "flat",
          "duration_ms": 220,
          "start_ms": 980,
          "end_ms": 1200,
          "is_missing": false,
          "is_extra": false
        }
      ],
      "accuracy": 0.42,
      "completeness": 1,
      "start_ms": 760,
      "end_ms": 1200,
      "char_start": 6,
      "char_end": 12,
      "hesitation_ms": null
    }
  ]
}