跳转到内容

Жедел аударма

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" }] мәнін қайтарады.
  • Тек бос орындардан тұратын сегменттер өзгеріссіз қайтарылады және ақысыз.
  • Сұраным денесі 2 МБ-ға дейін шектелген және сұраным ең көп дегенде 180 секундқа орындалады; клиенттік уақытша шектеулерді кемінде 180 секундқа белгілеңіз.
  • Idempotency-Key жіберіңіз. Желі үзілген немесе уақытша шектеу болғаннан кейін, бірдей кілт пен бірдей денемен қайта талап етіңіз; сізге екі рет ақы салынбайды.
  • Қол жетімсіз engine 400 қайтарады; егер кілтте таңдалған параметрді қамтымайтын рұқсат етілген параметрлер болса, 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 сұраныс параметрлері ескі кеңейтім нұсқалары үшін сақталады және нәтижеге әсер етпейді.
  • Аударылған суреттерді тікелей алу үшін, суретті жүктеп, аудару жұмысын жасаңыз.

POST /api/v1/ai/notes, /ai/chat және /ai/generate ескірген және 410-ге оралады.