add_nikud

Add full nikud (vowel points) to Hebrew text, for learners, vocalized display and text-to-speech, where unvocalized Hebrew is ambiguous. English terms and numbers pass through unchanged. The result is verified: `verified: true` means removing the points gives back the input; when false, `nikud` is the input unchanged. Up to 10,000 characters. Uses the monthly character quota.

Argument	Type	Description
text*	string	Hebrew text to vocalize, up to 10,000 characters. English terms and numbers pass through.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "examples": [
        "שלום עולם"
      ],
      "maxLength": 10000,
      "minLength": 1,
      "description": "Hebrew text to vocalize, up to 10,000 characters. English terms and numbers pass through."
    }
  }
}

add_terms

Add protected terms to the account, or update existing ones (matched by exact term text). Every later protected translation on the account (translate, translate_batch and the clinical tools) keeps these terms exactly as written, or uses `translations.he` / `.en` / `.ru` for that target language when set. Sending a term that already exists replaces its translations and note. Up to 2,000 terms per account, each up to 200 characters. Changes apply to new requests within 30 seconds. Free.

destructive

Argument	Type	Description
terms*	array

Input schema (JSON)

{
  "type": "object",
  "required": [
    "terms"
  ],
  "properties": {
    "terms": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "term"
        ],
        "properties": {
          "note": {
            "type": [
              "string",
              "null"
            ],
            "maxLength": 500
          },
          "term": {
            "type": "string",
            "examples": [
              "Optalgin"
            ],
            "maxLength": 200,
            "minLength": 1
          },
          "translations": {
            "type": "object",
            "examples": [
              {
                "he": "אופטלגין",
                "ru": "Оптальгин"
              }
            ],
            "properties": {
              "en": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1
              },
              "he": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1
              },
              "ru": {
                "type": "string",
                "maxLength": 200,
                "minLength": 1
              }
            },
            "additionalProperties": false
          }
        }
      },
      "maxItems": 2000,
      "minItems": 1
    }
  }
}

analyze_direction

Resolve the right-to-left / left-to-right structure of mixed Hebrew text: base direction, whether it mixes directions, dominant language and script, and the runs to render, where every left-to-right unit (a Latin term, a price, a range such as 10–20%, a date, a model number) stays whole. Send one `text`, or `fields` (a map of name → string, up to 100) to analyze a whole record at once. `base`: `auto` (default), `ltr` or `rtl`. Deterministic and free: no model, no character quota.

read-only

Argument	Type	Description
base	string	Paragraph direction to resolve against. `auto` (default) uses the first strong letter.
text	string	A single string, up to 20,000 characters. Send this or `fields`.
fields	object	A map of field name → string, up to 100 fields and 20,000 characters in total. Send this or `text`.

Input schema (JSON)

{
  "type": "object",
  "title": "AnalyzeRequest",
  "properties": {
    "base": {
      "enum": [
        "auto",
        "ltr",
        "rtl"
      ],
      "type": "string",
      "default": "auto",
      "examples": [
        "auto"
      ],
      "description": "Paragraph direction to resolve against. `auto` (default) uses the first strong letter."
    },
    "text": {
      "type": "string",
      "examples": [
        "שלום world"
      ],
      "maxLength": 20000,
      "minLength": 1,
      "description": "A single string, up to 20,000 characters. Send this or `fields`."
    },
    "fields": {
      "type": "object",
      "examples": [
        {
          "title": "מסמך Q3 ready",
          "subtitle": "Read the summary"
        }
      ],
      "description": "A map of field name → string, up to 100 fields and 20,000 characters in total. Send this or `text`.",
      "additionalProperties": {
        "type": "string",
        "maxLength": 20000
      }
    }
  },
  "description": "Provide exactly one of `text` (a single string) or `fields` (a map of name → string). Max 20,000 chars per string; up to 100 fields."
}

clinical_query

Turn a Hebrew clinical question (up to 2,000 characters) into an English query for a record search or an English model. English terms, numbers and dates are kept exactly, and Hebrew spellings of drug names are mapped back to English, preferring the patient's own terms in `known_terms` and the account terms. Counts 3× toward the monthly character quota.

Argument	Type	Description
text*	string	The Hebrew question, up to 2,000 characters.
glossary	object	English term → Hebrew rendering, used to map the Hebrew back to English.
known_terms	array	English terms from the patient's record, used to map Hebrew spellings back. Up to 500. Account terms are added automatically.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "examples": [
        "האם המטופלת עדיין לוקחת מטפורמין?"
      ],
      "maxLength": 2000,
      "minLength": 1,
      "description": "The Hebrew question, up to 2,000 characters."
    },
    "glossary": {
      "type": "object",
      "examples": [
        {
          "metformin": "מטפורמין"
        }
      ],
      "description": "English term → Hebrew rendering, used to map the Hebrew back to English.",
      "additionalProperties": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1
      }
    },
    "known_terms": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1
      },
      "examples": [
        [
          "metformin",
          "lisinopril"
        ]
      ],
      "maxItems": 500,
      "description": "English terms from the patient's record, used to map Hebrew spellings back. Up to 500. Account terms are added automatically."
    }
  }
}

clinical_translate

Translate a complete English clinical text (a discharge summary, patient instructions, a visit note, a model's answer) into Israeli medical Hebrew for a clinician or a patient. Drug names, doses, lab values, units, ICD-10 codes, clinical abbreviations, identifiers and every number are kept exactly; every sentence is checked for numbers, negation and laterality and reviewed for meaning. A sentence that fails is retried, then returned in English with status `fallback`: unverified Hebrew is never returned. Treat fallback sentences as untranslated. `audience`: `clinician` (default, keeps BID/PO shorthand) or `patient` (plain words). Pass the patient's medication and problem lists as `protected_terms`, names as `redact_terms` (hidden from the model), `reader_gender` and `patient_gender` when known, and `date_order` (US records are MDY). Counts 3× toward the monthly character quota.

Argument	Type	Description
bidi	string	`isolate` wraps English values in Unicode isolates so "5 mg" never renders as "mg 5". `none` returns plain text.
text*	string	English text, 1 to 20,000 characters. Markdown lists, headings and tables keep their structure. Counts toward the monthly character quota.
audience	string	Who reads the Hebrew. `clinician` (default) keeps shorthand such as BID and PO; `patient` writes dosing shorthand (BID, PRN) as plain words.
glossary	object	English term → required Hebrew rendering. Up to 500 entries.
date_order	string	How to read ambiguous numeric dates in the source. US records are MDY.

clinical_verify

Check Hebrew that was produced some other way (for example by your own model) against its English clinical source: every drug, dose, lab value, code and number must appear exactly, no number may be added, dates must be unambiguous, and negation and laterality must survive. `verification: "strict"` adds an independent model review for meaning changes; `standard` (default) is deterministic. Returns pass or fail with every issue. Counts 3× toward the monthly character quota.

Argument	Type	Description
source*	string	The English source, up to 20,000 characters.
glossary	object	English term → required Hebrew rendering.
date_order	string	How to read ambiguous numeric dates in the source.
translation*	string	The Hebrew to check, up to 40,000 characters.
redact_terms	array	Names replaced before the reviewer sees the text. Up to 200.
verification	string	`standard` (default) runs the deterministic checks. `strict` adds an independent model review for meaning changes.
protected_terms	array	Terms that must appear verbatim. Up to 500.

Input schema (JSON)

delete_term

Permanently delete one account term by its id (from list_terms or add_terms). Protected translations stop using it within 30 seconds. Free.

destructive

Argument	Type	Description
id*	string	The term id, from list_terms or add_terms.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "examples": [
        "3f2c1a9e-8b7d-4c6e-9f10-2a3b4c5d6e7f"
      ],
      "description": "The term id, from list_terms or add_terms."
    }
  }
}

detect_language

Detect the dominant language, script and direction of a string, with one segment per language. Built for short, code-switched input (chat messages, search queries, voice transcripts): a brand or acronym such as "PayPal" or "API" inside a Hebrew or Russian sentence does not change the dominant language. Use it to pick `source_lang` or the reply language before translating. Latin script is tagged `en`. Deterministic and free: no character quota.

read-only

Argument	Type	Description
text*	string	Text to classify, up to 20,000 characters. Built for short, code-switched input.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "examples": [
        "Можно оплатить через PayPal сегодня?"
      ],
      "maxLength": 20000,
      "minLength": 1,
      "description": "Text to classify, up to 20,000 characters. Built for short, code-switched input."
    }
  }
}

health

Check that the HebrewCore API is up and its database reachable. Needs no API key and uses no quota.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_languages

List every language HebrewCore translates to and from, with its code (use it as `source_lang` / `target_lang`), English and native name, and writing direction. Protected translation covers Hebrew, English and Russian. Free.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_terms

List the account's protected terms: drug, product and brand names that every protected translation on the account keeps exactly as written (or renders with the term's per-language translation when one is set). Returns each term's id, which delete_term needs. Free.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

strip_nikud

Remove nikud, dagesh and cantillation marks from Hebrew text, keeping punctuation such as the maqaf. Use it to normalize text for search keys, comparison and de-duplication, or to get display text back from vocalized text. Deterministic and free: no character quota.

read-only

Argument	Type	Description
text*	string	Hebrew text with nikud or cantillation, up to 20,000 characters.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "examples": [
        "שָׁלוֹם"
      ],
      "maxLength": 20000,
      "minLength": 1,
      "description": "Hebrew text with nikud or cantillation, up to 20,000 characters."
    }
  }
}

translate

Translate one text between Hebrew, English, Russian and the other languages from list_languages. Use it for product, support, interface, finance, legal and general clinical text. Returns the translation with its direction metadata. Protected translation: set `protect: true`, a `domain` (`general`, `clinical`, `finance`, `legal`) or any protection field, and prices, quantities, numbers, dates, codes, identifiers, product names, interface variables ({name}, %s) and `protected_terms` are kept exactly as written, and every sentence is verified; a sentence that cannot be verified comes back in the source language (status `fallback`) instead of a wrong value. `finance` also protects IBANs, card and account numbers and checks credit/debit direction; `legal` keeps clause references, citations and defined terms and checks shall/may modality; `clinical` protects drugs, doses and lab values. Gender: `listener_gender` is the reader ("you"), `speaker_gender` the speaker ("I", e.g. an assistant). `glossary` maps source terms to required renderings; `redact_terms` keeps names exact and hidden from the model. `message_format: "icu"` translates an ICU MessageFormat string and rewrites plural branches for Hebrew and Russian. `quality`: `fast`, `balanced` (default) or `smartest`. Uses the monthly character quota. For many short strings use translate_batch; for full English clinical documents into Hebrew use clinical_translate.

Argument	Type	Description
bidi	string	`isolate` wraps protected values in Unicode isolates in Hebrew output. Default none; see /v1/wrap.
text*	string	Text to translate, 1 to 20,000 characters. Counts toward the monthly character quota.
domain	string	`general` (default) for product, commerce, support and interface text. `clinical` adds clinical register and drug, dose, lab and abbreviation detection. `finance` adds a formal banking register, protects IBANs, SWIFT/BIC codes, bank account numbers (including Israeli bank-branch-account), Israeli ID numbers and card numbers (check digits verified; these values are never shown to the model), invoice, policy and transaction references, signed amounts, rates and basis points, and checks that every money direction (credit/debit, deposit/withdrawal, buy/sell, increase/decrease, gain/loss, who owes whom) is kept. `legal` adds a formal legal register, protects clause and section references (Section 4.2, Clause 7(b), סעיף 12(א), § 3) and case and statute citations, renders each defined term ("the Company") the same way throughout, and checks that modality (shall, may, shall not, is not required to) is kept. Any value implies `protect`.

translate_batch

Translate 1 to 50 strings (each up to 5,000 characters) into one target language in a single call; results come back in input order. Use it for the interface strings of a screen, a string file, or the fields of a product. Takes every option of translate: `protect`, `domain` (`general`, `clinical`, `finance`, `legal`), `protected_terms`, `glossary`, `listener_gender`, `speaker_gender`, `message_format: "icu"` and `quality`. With protection, interface variables such as {count}, {{name}} and %s, numbers, prices and dates stay exactly as written, and each item carries its own verification status. Uses the monthly character quota.

Argument	Type	Description
bidi	string	`isolate` wraps protected values in Unicode isolates in Hebrew output. Default none; see /v1/wrap.
items*	array	1 to 50 strings, each up to 5,000 characters. A protected batch carries at most 20,000 characters in total.
domain	string	`general` (default) for product, commerce, support and interface text. `clinical` adds clinical register and drug, dose, lab and abbreviation detection. `finance` adds a formal banking register, protects IBANs, SWIFT/BIC codes, bank account numbers (including Israeli bank-branch-account), Israeli ID numbers and card numbers (check digits verified; these values are never shown to the model), invoice, policy and transaction references, signed amounts, rates and basis points, and checks that every money direction (credit/debit, deposit/withdrawal, buy/sell, increase/decrease, gain/loss, who owes whom) is kept. `legal` adds a formal legal register, protects clause and section references (Section 4.2, Clause 7(b), סעיף 12(א), § 3) and case and statute citations, renders each defined term ("the Company") the same way throughout, and checks that modality (shall, may, shall not, is not required to) is kept. Any value implies `protect`.

transliterate

Romanize Hebrew into Latin letters (`direction: "he-to-latin"`, the default), or write Latin spelling in Hebrew letters (`direction: "latin-to-he"`) for name entry and search. Up to 5,000 characters. Uses the monthly character quota.

Argument	Type	Description
text*	string	Text to transliterate, up to 5,000 characters.
direction	string	`he-to-latin` (default) romanizes Hebrew. `latin-to-he` writes Latin spelling in Hebrew letters, for name entry and search.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "examples": [
        "שלום"
      ],
      "maxLength": 5000,
      "minLength": 1,
      "description": "Text to transliterate, up to 5,000 characters."
    },
    "direction": {
      "enum": [
        "he-to-latin",
        "latin-to-he"
      ],
      "type": "string",
      "default": "he-to-latin",
      "examples": [
        "he-to-latin"
      ],
      "description": "`he-to-latin` (default) romanizes Hebrew. `latin-to-he` writes Latin spelling in Hebrew letters, for name entry and search."
    }
  }
}

wrap_for_display

Make one mixed Hebrew/English display line render correctly: every left-to-right unit (a Latin term, a price, a number with its unit, a range such as "10–20%", a date, a comparison such as "<5") is kept whole and in order, so nothing is reversed or mirrored inside a Hebrew line. `format`: `html` (dir spans, for web and React), `isolate` (Unicode isolates, for iOS, Android 7+ and browsers) or `marks` (LRM/RLM, for any renderer including older Android). Pass `base: "rtl"` for a Hebrew line that starts with a Latin term. Deterministic and free: no character quota.

read-only

Argument	Type	Description
base	string	Paragraph direction of the display surface. Pass `rtl` for a Hebrew line even when it starts with a Latin term.
text*	string	The display line, up to 20,000 characters.
format	string	`html` for the web; `isolate` (Unicode isolates) for modern text engines; `marks` (LRM/RLM) for every renderer, including older Android.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "base": {
      "enum": [
        "auto",
        "ltr",
        "rtl"
      ],
      "type": "string",
      "default": "auto",
      "examples": [
        "rtl"
      ],
      "description": "Paragraph direction of the display surface. Pass `rtl` for a Hebrew line even when it starts with a Latin term."
    },
    "text": {
      "type": "string",
      "examples": [
        "הנחה: 10–20% על Galaxy S25 עד 31/12"
      ],
      "maxLength": 20000,
      "minLength": 1,
      "description": "The display line, up to 20,000 characters."
    },
    "format": {
      "enum": [
        "html",
        "isolate",
        "marks"
      ],
      "type": "string",
      "default": "html",
      "examples": [
        "html"
      ],
      "description": "`html` for the web; `isolate` (Unicode isolates) for modern text engines; `marks` (LRM/RLM) for every renderer, including older Android."
    }
  }
}

HebrewCore by baba Hebrew

Try it

add_nikud

HebrewCore by baba Hebrew

Try it

add_nikud

Tools (16)