Миттєвий переклад
Короткий переклад тексту
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" }]у порядку запиту. - Сегменти, які містять лише пробіли, повертаються без змін і не оплачуються.
Умовні позначення
Section titled “Умовні позначення”- Тіло запиту обмежене 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зберігаються для старих версій розширення і не впливають на результат. - Щоб отримати перекладені зображення безпосередньо, завантажте зображення та створіть завдання перекладу.
Закриті кінцеві точки
Section titled “Закриті кінцеві точки”POST /api/v1/ai/notes, /ai/chat та /ai/generate вилучено зі списку та повертають 410.