Skip to content
HALOWERK

Tonwerk

pronunciation lexicon

Generate mode: takes entries (graphemes plus IPA or X-SAMPA pronunciations and/or aliases) and writes a PLS 1.0 lexicon (namespace, version, alphabet, xml:lang) in IPA or X-SAMPA, converting between them with the X-SAMPA table of J. C. Wells. Check mode: parses an existing lexicon. Both modes validate the PLS content model (at least one grapheme and one phoneme or alias per lexeme), IPA characters (no capitals or foreign symbols), missing primary stress, duplicate graphemes, NFD form and.

POST https://ton.halowerk.com/v1/pronunciation-lexicon

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
langstringNoBCP 47 language of the lexicon.
alphabetstringNoAlphabet of the generated lexicon.
entriesarrayNoGenerate mode.
pls_xmlstringNoCheck mode: an existing PLS document.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "lang": {
      "type": "string",
      "maxLength": 35,
      "default": "de-DE",
      "description": "BCP 47 language of the lexicon."
    },
    "alphabet": {
      "type": "string",
      "enum": [
        "ipa",
        "x-sampa"
      ],
      "default": "ipa",
      "description": "Alphabet of the generated lexicon."
    },
    "entries": {
      "type": "array",
      "minItems": 1,
      "maxItems": 500,
      "description": "Generate mode.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "graphemes"
        ],
        "properties": {
          "graphemes": {
            "type": "array",
            "minItems": 1,
            "maxItems": 10,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          "ipa": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          "x_sampa": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          },
          "aliases": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            }
          }
        }
      }
    },
    "pls_xml": {
      "type": "string",
      "minLength": 10,
      "maxLength": 500000,
      "description": "Check mode: an existing PLS document."
    }
  }
}

Open original schema

Published input example

{
  "lang": "de-DE",
  "entries": [
    {
      "graphemes": [
        "HALOWERK"
      ],
      "ipa": [
        "ˈhaːloˌvɛʁk"
      ]
    },
    {
      "graphemes": [
        "x402"
      ],
      "aliases": [
        "x vier null zwei"
      ]
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →