Traducere instantanee
Traducere scurtă de text
Section titled “Traducere scurtă de text”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" }Traducere segmentată în lot
Section titled “Traducere segmentată în lot”POST /api/v1/ai/translate-batch{ "segments": [ { "id": "p1", "text": "First paragraph." }, { "id": "p2", "text": "Second paragraph." } ], "target_lang": "zh"}segmentsconține 1–64 de segmente, fiecare având cel mult 4000 de caractere; fiecareideste 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ă.
Convenții
Section titled “Convenții”- 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
engineindisponibil 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ă.
Recunoașterea textului din imagini
Section titled “Recunoașterea textului din imagini”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șiyreprezintă 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;
confidencereprezintă gradul de încredere al recunoașterii pentru acea linie (0–1). Dacă nu se găsește niciun text, răspunsul este200cublocksgol. - 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ă îndetail; î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șilangsunt 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.
Puncte terminale retrase
Section titled “Puncte terminale retrase”POST /api/v1/ai/notes, /ai/chat și /ai/generate sunt retrase din circulație și returnează 410.