Sari la conținut

Traducere instantanee

POST /api/v1/ai/translate-snippet
{
"text": "Hello world",
"source_lang": "auto",
"target_lang": "zh",
"engine": "xr-397b"
}

text are 1–5000 de caractere. target_lang și source_lang (cu excepția lui auto) trebuie să fie coduri de limbă suportate, în caz contrar 422. Răspuns:

{ "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 conține 1–64 de segmente, fiecare având cel mult 4000 de caractere; fiecare id este unic în cadrul cererii (1–64 de caractere). Dacă numărul de segmente este prea mare sau dacă un segment este prea lung, se returnează 413.
  • Răspunsul returnează segments: [{ "id", "translated_text" }] în ordinea cererii.
  • Segmentele care conțin doar spații albe sunt returnate așa cum sunt și nu se facturează.
  • Corpul cererii este limitat la 2 MB, iar o cerere poate dura cel mult 180 de secunde; setați limitele de timp ale clientului la cel puțin 180 de secunde.
  • Trimiteți un Idempotency-Key. După o scădere a conexiunii sau după expirarea temporizatorului, reîncercați cu aceeași cheie și același corp; nu veți fi facturați de două ori.
  • Un engine indisponibil returnează 400; dacă cheia are setări permise care nu includ cea selectată, 403.
  • Se calculează în funcție de cantitatea de text sursă efectiv procesată.
POST /api/v1/ai/ocr

Încărcați imaginea în câmpul file al multipart/form-data (PNG, JPEG, WebP, BMP, GIF, până la 12 MB și 25 de milioane de pixeli), sau trimiteți imaginea ca body al cererii. Răspunsul returnează textul rând cu rând, cu coordonatele pixelilor:

{
"width": 640,
"height": 240,
"engine": "omnidoc-ocr",
"blocks": [
{ "text": "编号 INV-20261029-0042", "confidence": 0.97, "x": 23, "y": 76, "w": 366, "h": 33 }
]
}
  • x și y reprezintă colțul stâng sus al liniei de text, în coordonatele imaginii încărcate (un JPEG cu date de orientare este citit vertical).
  • Fiecare casetă pe câte o linie; confidence reprezintă gradul de încredere al recunoașterii pentru acea linie (0–1). Dacă nu se găsește niciun text, răspunsul este 200 cu blocks gol.
  • Recunoașterea textului din imagini nu consumă credit. Imaginile mai narrow sau mai scurte de 11 pixeli returnează un rezultat gol.
  • Dacă recunoașterea este temporar indisponibilă, răspunsul este 503; la expirarea temporizatorului, 504, cu o explicație în chineză în detail; încercați din nou mai târziu.
  • Autentizarea extensiei de traducere web (omnidoc.translate.use), cheile API și autentificarea prin browser pot toate să o inițieze.
  • Parametrii de query engine, scene și lang sunt păstrați pentru versiunile mai vechi ale extensiei și nu afectează rezultatul.
  • Pentru a obține imagini traduse direct, încărcați imaginea și creați un job de traducere.

POST /api/v1/ai/notes, /ai/chat și /ai/generate sunt retrase din circulație și returnează 410.