Saltearse al contenido

Traducción instantánea

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

text tiene entre 1 y 5000 caracteres. target_lang y source_lang (excepto auto) deben ser códigos de idioma admitidos; en caso contrario, 422. Respuesta:

{ "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 almacena de 1 a 64 segmentos, cada uno con un máximo de 4000 caracteres; cada id es único dentro de la solicitud (de 1 a 64 caracteres). Si hay demasiados segmentos o un segmento es demasiado largo, se devuelve 413.
  • La respuesta devuelve segments: [{ "id", "translated_text" }] en el orden de la solicitud.
  • Los segmentos que contienen solo espacios en blanco se devuelven tal cual y no se facturan.
  • El cuerpo de la solicitud está limitado a 2 MB y una solicitud puede ejecutarse durante un máximo de 180 segundos; configure los tiempos de espera del cliente para que sean de al menos 180 segundos.
  • Envíe un Idempotency-Key. Tras una caída de la red o un tiempo de espera agotado, vuelva a intentarlo con la misma clave y el mismo cuerpo; no se le cobrará dos veces.
  • Un engine no disponible devuelve 400; si la clave tiene configuraciones permitidas que no incluyen la seleccionada, 403.
  • Se factura según la cantidad de texto fuente realmente procesado.
POST /api/v1/ai/ocr

Suba la imagen en el campo file de multipart/form-data (PNG, JPEG, WebP, BMP, GIF, hasta 12 MB y 25 millones de píxeles), o envíe la imagen como cuerpo de la solicitud. La respuesta proporciona el texto línea por línea con coordenadas de píxeles:

{
"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 y son las coordenadas de la esquina superior izquierda de la línea de texto, en el sistema de coordenadas de la imagen cargada (una JPEG con datos de orientación se lee en posición vertical).
  • Una caja por línea; confidence es la confianza de reconocimiento de esa línea (0–1). Si no se encuentra texto, la respuesta es 200 con blocks vacío.
  • El reconocimiento de texto en imágenes no consume créditos. Las imágenes con menos de 11 píxeles de ancho o altura devuelven un resultado vacío.
  • Si el reconocimiento está temporalmente indisponible, la respuesta es 503; en caso de tiempo de espera, 504, con una explicación en chino en detail; inténtelo de nuevo más tarde.
  • La extensión de traducción web, mediante inicio de sesión (omnidoc.translate.use), claves API e inicio de sesión en el navegador, puede invocarla.
  • Los parámetros de consulta engine, scene y lang se conservan para versiones antiguas de la extensión y no afectan al resultado.
  • Para obtener imágenes traducidas directamente, suba la imagen y cree un trabajo de traducción.

POST /api/v1/ai/notes, /ai/chat y /ai/generate están retirados y devuelven 410.