Жедел аударма
Қысқа мәтін аудармасы
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әрқайсысы ең көп дегенде 4000 таңбадан тұратын 1–64 бөлікті сақтайды; әрidсұраным ішінде бірегей болады (1–64 таңба). Бөліктердің тым көптігі немесе бөліктің тым ұзын болуы413қатесін қайтарады.- Жауап сұраныс ретімен
segments: [{ "id", "translated_text" }]мәнін қайтарады. - Тек бос орындардан тұратын сегменттер өзгеріссіз қайтарылады және ақысыз.
Шарттар
Section titled “Шарттар”- Сұраным денесі 2 МБ-ға дейін шектелген және сұраным ең көп дегенде 180 секундқа орындалады; клиенттік уақытша шектеулерді кемінде 180 секундқа белгілеңіз.
Idempotency-Keyжіберіңіз. Желі үзілген немесе уақытша шектеу болғаннан кейін, бірдей кілт пен бірдей денемен қайта талап етіңіз; сізге екі рет ақы салынбайды.- Қол жетімсіз
engine400қайтарады; егер кілтте таңдалған параметрді қамтымайтын рұқсат етілген параметрлер болса,403. - Нақты өңделген бастапқы мәтін көлеміне сәйкес есептеледі.
Суреттегі мәтінді тану
Section titled “Суреттегі мәтінді тану”POST /api/v1/ai/ocrСуретті multipart/form-data (PNG, JPEG, WebP, BMP, GIF) өрісіндегі file өрісіне жүктеңіз (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-ге оралады.