Traduzione istantanea
Traduzione breve del testo
Sezione intitolata “Traduzione breve del testo”POST /api/v1/ai/translate-snippet{ "text": "Hello world", "source_lang": "auto", "target_lang": "zh", "engine": "xr-397b"}text è compreso tra 1 e 5000 caratteri. target_lang e source_lang (diversi da auto) devono essere codici lingua supportati; in caso contrario, 422. Risposta:
{ "translated_text": "你好,世界", "source_lang": "auto", "target_lang": "zh" }Traduzione batch di segmenti
Sezione intitolata “Traduzione batch di segmenti”POST /api/v1/ai/translate-batch{ "segments": [ { "id": "p1", "text": "First paragraph." }, { "id": "p2", "text": "Second paragraph." } ], "target_lang": "zh"}segmentscontiene da 1 a 64 segmenti, ciascuno di massimo 4000 caratteri; ogniidè unico all’interno della richiesta (da 1 a 64 caratteri). Un numero eccessivo di segmenti o un segmento troppo lungo generano l’errore413.- La risposta restituisce
segments: [{ "id", "translated_text" }]nell’ordine della richiesta. - I segmenti che contengono solo spazi bianchi vengono restituiti così come sono e non sono addebitati.
Convenzioni
Sezione intitolata “Convenzioni”- Il corpo della richiesta è limitato a 2 MB e una richiesta può durare al massimo 180 secondi; impostare i timeout del client ad almeno 180 secondi.
- Invia un
Idempotency-Key. Dopo una perdita di connessione o un timeout, riprova con la stessa chiave e lo stesso corpo; non ti verrà addebitato due volte. - Un
enginenon disponibile restituisce400; se la chiave dispone di impostazioni consentite che non includono quella selezionata,403. - Addebitato in base alla quantità di testo sorgente effettivamente elaborata.
Riconoscimento del testo nelle immagini
Sezione intitolata “Riconoscimento del testo nelle immagini”POST /api/v1/ai/ocrCarica l’immagine nel campo file di multipart/form-data (PNG, JPEG, WebP, BMP, GIF, fino a 12 MB e 25 milioni di pixel), oppure invia l’immagine come corpo della richiesta. La risposta restituisce il testo riga per riga con le coordinate dei pixel:
{ "width": 640, "height": 240, "engine": "omnidoc-ocr", "blocks": [ { "text": "编号 INV-20261029-0042", "confidence": 0.97, "x": 23, "y": 76, "w": 366, "h": 33 } ]}xeysono l’angolo in alto a sinistra della riga di testo, nelle coordinate dell’immagine caricata (un JPEG con dati di orientamento viene letto in posizione verticale).- Una casella per riga;
confidenceè la confidenza di riconoscimento di quella riga (0–1). Se non viene trovato alcun testo, la risposta è200conblocksvuoto. - Il riconoscimento del testo nelle immagini non comporta alcun costo in crediti. Le immagini con una larghezza o un’altezza inferiore a 11 pixel restituiscono un risultato vuoto.
- Se il riconoscimento è temporaneamente indisponibile, la risposta è
503; in caso di timeout,504, con una spiegazione in cinese indetail; riprova più tardi. - L’accesso estensione di traduzione web (
omnidoc.translate.use), le chiavi API e l’accesso tramite browser possono tutti chiamarlo. - I parametri di query
engine,sceneelangvengono mantenuti per le versioni precedenti dell’estensione e non influenzano il risultato. - Per ottenere direttamente le immagini tradotte, carica l’immagine e crea un lavoro di traduzione.
Endpoint in pensione
Sezione intitolata “Endpoint in pensione”POST /api/v1/ai/notes, /ai/chat e /ai/generate sono stati ritirati e restituiscono 410.