Salta ai contenuti

Traduzione istantanea

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" }
POST /api/v1/ai/translate-batch
{
"segments": [
{ "id": "p1", "text": "First paragraph." },
{ "id": "p2", "text": "Second paragraph." }
],
"target_lang": "zh"
}
  • segments contiene da 1 a 64 segmenti, ciascuno di massimo 4000 caratteri; ogni id è unico all’interno della richiesta (da 1 a 64 caratteri). Un numero eccessivo di segmenti o un segmento troppo lungo generano l’errore 413.
  • 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.
  • 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 engine non disponibile restituisce 400; se la chiave dispone di impostazioni consentite che non includono quella selezionata, 403.
  • Addebitato in base alla quantità di testo sorgente effettivamente elaborata.
POST /api/v1/ai/ocr

Carica 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 }
]
}
  • x e y sono 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 è 200 con blocks vuoto.
  • 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 in detail; 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, scene e lang vengono 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.

POST /api/v1/ai/notes, /ai/chat e /ai/generate sono stati ritirati e restituiscono 410.