Skip to main content
Параметр dictionary передаёт модели термины, имена и собственные названия, чтобы подсказать их написание в распознанном тексте.
Словарь бесплатный: оплачивается только распознавание.
Словарь не гарантирует правильное распознавание всех терминов.

Где работает

Работает с диаризацией и без. Распознавание со словарём идёт на модели palatine_large_highspeed (или palatine_small, если вы указали её). Режим — только fast_inference=true (по умолчанию). С fast_inference=false вернётся 422.

Формат

Передайте термины одним из способов:
  • повторите параметр на каждый термин: dictionary=Palatine Speech&dictionary=Екатерина;
  • одной строкой через запятую: dictionary=Palatine Speech, Екатерина;
  • JSON-массивом: dictionary=["Palatine Speech", "Екатерина"].
Если в термине есть запятая (Сервис, версия 2), передайте термины повтором параметра или JSON-массивом.

Ограничения

При превышении запрос отклоняется с кодом 422, задача не создаётся. Пустые строки и повторы (без учёта регистра) отбрасываются. Советы:
  • Пишите термины в начальной форме и так, как они должны выглядеть в тексте: «Екатерина», «Palatine Speech». Форму слова в результате определяет модель.
  • Включайте только то, что модель путает. Общеупотребительные слова в словаре не нужны.
  • Если язык записи известен, задайте его параметром language (см. Поддерживаемые языки).

Пример

Словарь или prompt

В /audio/transcriptions работает и параметр prompt из OpenAI API — свободная подсказка распознаванию. Для списка названий и имён надёжнее dictionary. Передавать prompt и dictionary в одном запросе нельзя — вернётся 422. Подробнее о prompt — в разделе Транскрибация и диаризация, блок «Транскрибация в формате OpenAI».