Skip to main content
POST
/
v1
/
pronunciation
/
dictionaries
Create pronunciation dictionary
curl --request POST \
  --url https://api.slng.ai/v1/pronunciation/dictionaries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "brand-pronunciations",
  "metadata": {
    "language": "hi-IN",
    "providers": [
      "sarvam",
      "cartesia"
    ]
  },
  "modes": {
    "rewrite": {
      "rules": [
        {
          "match": "NAIC",
          "replace": "en ay eye see"
        },
        {
          "match": "B2B",
          "replace": "bee to bee"
        }
      ]
    }
  }
}
'
{
  "id": "pd_01abc...",
  "org_id": "org_123",
  "name": "brand-pronunciations",
  "normalized_name": "brand-pronunciations",
  "modes": {
    "rewrite": {
      "rules": [
        {
          "match": "NAIC",
          "replace": "en ay eye see"
        }
      ]
    },
    "ipa": {
      "rules": [
        {
          "match": "SLNG",
          "ipa": "slɪŋ"
        }
      ]
    }
  },
  "content_hash": "sha256:...",
  "created_at": "2026-05-15T12:00:00.000Z",
  "metadata": {
    "language": "hi-IN",
    "providers": [
      "sarvam",
      "cartesia"
    ]
  },
  "created_by_key_label": "production-key"
}
For workflow examples, see the Pronunciation dictionaries guide.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
required

Unique dictionary name within the authenticated organization.

Maximum string length: 128
Pattern: ^[A-Za-z0-9._-]+$
Example:

"brand-pronunciations"

​
modes
object
required

Pronunciation modes stored on the dictionary. Only rewrite is executable today.

​
metadata
object

Optional application metadata stored with the dictionary.

Example:
{
  "language": "hi-IN",
  "providers": ["sarvam", "cartesia"]
}

Response

Pronunciation dictionary created.

​
id
string
required

Immutable pronunciation dictionary identifier.

Example:

"pd_01abc..."

​
org_id
string
required

Organization that owns the dictionary.

Example:

"org_123"

​
name
string
required

Dictionary name.

Example:

"brand-pronunciations"

​
normalized_name
string
required

Normalized dictionary name used for lookups.

Example:

"brand-pronunciations"

​
modes
object
required

Pronunciation modes stored on the dictionary. Only rewrite is executable today.

​
content_hash
string
required

Content hash for the stored dictionary.

Example:

"sha256:..."

​
created_at
string<date-time>
required

Creation timestamp.

Example:

"2026-05-15T12:00:00.000Z"

​
metadata
object

Optional application metadata stored with the dictionary.

Example:
{
  "language": "hi-IN",
  "providers": ["sarvam", "cartesia"]
}
​
created_by_key_label
string

API key label that created the dictionary, when available.

Example:

"production-key"