LLM переводят с учётом контекста и стиля, а через Heli API можно выбрать модель под задачу: быструю для потока документации и поддержки или сильную для маркетинга и художественных текстов. Ключ sk-heli- создаётся во вкладке «Ключи» после регистрации на getheli.ru.
Выбор модели
Качество сильно зависит от языковой пары и тематики, поэтому проверьте 2–3 модели на 20–30 своих типичных фрагментах. Пусть их оценит носитель языка или редактор, который знает предмет.
- Массовый перевод (поддержка, документация, карточки товаров): openai/gpt-5.4-mini или google/gemini-3.5-flash.
- Большие объёмы с простым языком: google/gemini-3.5-flash-lite или deepseek/deepseek-v4-flash.
- Маркетинг, UX-тексты, литературный стиль: anthropic/claude-sonnet-5 или openai/gpt-5.5.
Промпт для перевода
Глоссарий и указание тона делают перевод единообразным между запросами. Модель не помнит прошлые запросы, поэтому глоссарий передавайте в каждом.
system = """Переведи текст с русского на английский.
Тон: деловой, без канцелярита.
Глоссарий: «баланс» -> balance, «кабинет» -> dashboard, «ключ» -> API key.
Не переводи и не меняй: HTML-теги, Markdown-разметку, плейсхолдеры вида {name} и %s, URL, код.
Верни только перевод, без пояснений."""
resp = client.chat.completions.create(
model="openai/gpt-5.4-mini",
messages=[{"role": "system", "content": system},
{"role": "user", "content": text}],
max_tokens=4000,
)
translation = resp.choices[0].message.contentФайлы локализации и длинные тексты
- JSON-файлы интерфейса переводите пачками по 50–100 строк и просите вернуть JSON с теми же ключами. После ответа сверьте кодом, что набор ключей совпал и плейсхолдеры на месте.
- Длинные документы делите по абзацам или разделам, а не по числу символов, чтобы не разрывать предложения. Добавляйте в запрос краткое описание документа, чтобы сохранить контекст.
- Следите за finish_reason: значение length означает, что перевод обрезан лимитом max_tokens.
Контроль качества
Для важных текстов используйте вторую модель как редактора: она получает оригинал и перевод и перечисляет смысловые ошибки, пропуски и нарушения глоссария. Юридические и медицинские тексты после машинного перевода должен проверить специалист.
Если переводите страницы сайта, учитывайте поисковики: Яндекс относит низкокачественный автоматический перевод к неоригинальному контенту, поэтому переводные страницы тоже нужно вычитывать.
Большие объёмы
Тысячи фрагментов отправляйте параллельно, но с ограничением числа одновременных запросов. При ответе 429 повторяйте запрос с паузой из заголовка Retry-After, а переведённые фрагменты сохраняйте по мере готовности, чтобы после сбоя не начинать заново. Для массового перевода заведите отдельный ключ с бюджетом во вкладке «Лимиты».
Попробуйте Heli
Ключ sk-heli- появляется после подтверждения почты. Через Google и Яндекс — сразу в кабинете.