Traducción instantánea
Traducción breve de texto
Sección titulada «Traducción breve de texto»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" }Traducción por lotes de segmentos
Sección titulada «Traducción por lotes de segmentos»POST /api/v1/ai/translate-batch{ "segments": [ { "id": "p1", "text": "First paragraph." }, { "id": "p2", "text": "Second paragraph." } ], "target_lang": "zh"}segmentsalmacena de 1 a 64 segmentos, cada uno con un máximo de 4000 caracteres; cadaides único dentro de la solicitud (de 1 a 64 caracteres). Si hay demasiados segmentos o un segmento es demasiado largo, se devuelve413.- 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.
Convenciones
Sección titulada «Convenciones»- 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
engineno disponible devuelve400; si la clave tiene configuraciones permitidas que no incluyen la seleccionada,403. - Se factura según la cantidad de texto fuente realmente procesado.
Reconocimiento de texto en imágenes
Sección titulada «Reconocimiento de texto en imágenes»POST /api/v1/ai/ocrSuba 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 } ]}xyyson 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;
confidencees la confianza de reconocimiento de esa línea (0–1). Si no se encuentra texto, la respuesta es200conblocksvací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 endetail; 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,sceneylangse 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.
Puntos finales retirados
Sección titulada «Puntos finales retirados»POST /api/v1/ai/notes, /ai/chat y /ai/generate están retirados y devuelven 410.