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(см. Поддерживаемые языки).
Пример
- Python
- cURL
- OpenAI SDK
Словарь или prompt
В /audio/transcriptions работает и параметр prompt из OpenAI API — свободная подсказка
распознаванию. Для списка названий и имён надёжнее dictionary. Передавать prompt и
dictionary в одном запросе нельзя — вернётся 422. Подробнее о prompt — в разделе
Транскрибация и диаризация, блок «Транскрибация в формате OpenAI».