Мгновенный перевод
Краткий перевод текста
Заголовок раздела «Краткий перевод текста»POST /api/v1/ai/translate-snippet{ "text": "Hello world", "source_lang": "auto", "target_lang": "zh", "engine": "xr-397b"}text составляет от 1 до 5000 символов. target_lang и source_lang (за исключением auto) должны быть кодами поддерживаемых языков; в противном случае используется 422. Ответ:
{ "translated_text": "你好,世界", "source_lang": "auto", "target_lang": "zh" }Пакетный перевод сегментов
Заголовок раздела «Пакетный перевод сегментов»POST /api/v1/ai/translate-batch{ "segments": [ { "id": "p1", "text": "First paragraph." }, { "id": "p2", "text": "Second paragraph." } ], "target_lang": "zh"}segmentsсодержит от 1 до 64 сегментов, каждый из которых не превышает 4000 символов; каждыйidуникален в пределах запроса (от 1 до 64 символов). Если сегментов слишком много или один из них слишком длинный, возвращается ошибка413.- Ответ возвращает
segments: [{ "id", "translated_text" }]в порядке запроса. - Сегменты, содержащие только пробелы, возвращаются без изменений и не тарифицируются.
Условные обозначения
Заголовок раздела «Условные обозначения»- Тело запроса ограничено 2 МБ, а время выполнения запроса — максимум 180 секунд; установите таймауты клиента не менее чем на 180 секунд.
- Отправьте
Idempotency-Key. После обрыва соединения или тайм-аута повторите запрос с тем же ключом и тем же телом; дважды плата не взимается. - Недоступный
engineвозвращает400; если для данного ключа предусмотрены допустимые настройки, не включающие выбранный вариант, то403. - Оплата производится по фактически обработанному объёму исходного текста.
Распознавание текста на изображениях
Заголовок раздела «Распознавание текста на изображениях»POST /api/v1/ai/ocrЗагрузите изображение в поле file multipart/form-data (PNG, JPEG, WebP, BMP, GIF, размером до 12 МБ и 25 миллионов пикселей), либо передайте изображение в теле запроса. В ответе текст будет представлен построчно с указанием координат пикселей:
{ "width": 640, "height": 240, "engine": "omnidoc-ocr", "blocks": [ { "text": "编号 INV-20261029-0042", "confidence": 0.97, "x": 23, "y": 76, "w": 366, "h": 33 } ]}xиy— это координаты верхнего левого угла строки текста в системе координат загруженного изображения (изображение JPEG с данными об ориентации считывается в прямом положении).- Каждая строка — один блок;
confidence— уровень достоверности распознавания для этой строки (от 0 до 1). Если текст не найден, в ответе содержится200с пустымblocks. - Распознавание текста на изображениях не потребляет кредиты. Изображения шириной или высотой менее 11 пикселей возвращают пустой результат.
- Если распознавание временно недоступно, ответ —
503; при тайм-ауте —504, с китайским пояснением вdetail; попробуйте позже. - Вход в систему расширения веб-перевода (
omnidoc.translate.use), ключи API и вход через браузер — все они могут вызывать эту функцию. - Параметры запроса
engine,sceneиlangсохраняются для старых версий расширения и не влияют на результат. - Чтобы получить переведённые изображения напрямую, загрузите изображение и создайте задание на перевод.
Отключённые конечные точки
Заголовок раздела «Отключённые конечные точки»POST /api/v1/ai/notes, /ai/chat и /ai/generate сняты с производства и возвращают 410.