Перейти до вмісту

Миттєвий переклад

Короткий переклад тексту

Section titled “Короткий переклад тексту”
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" }

Пакетний переклад сегментів

Section titled “Пакетний переклад сегментів”
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.
  • Оплата здійснюється за обсяг фактично опрацьованого вихідного тексту.

Розпізнавання тексту на зображеннях

Section titled “Розпізнавання тексту на зображеннях”
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.