Перейти к содержимому

Мгновенный перевод

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.