APIS

Tabla de contenido

El presente proyecto soporta dos tipos de APIs, todos los métodos necesitan Redis;

• Llamadas funcionales en Python
• Protocolos HTTP

Python

Como pdf2zh es un módulo instalado en Python, exponemos dos métodos para que otros programas puedan llamar en cualquier script de Python.

Por ejemplo, si deseas traducir un documento del inglés al chino usando Google Translate, puedes usar el siguiente código:

from pdf2zh_next import translate, translate_stream

params = {
    'lang_in': 'en',
    'lang_out': 'zh',
    'service': 'google',
    'thread': 4,
}

(file_mono, file_dual) = translate(files=['example.pdf'], **params)[0]

with open('example.pdf', 'rb') as f:
    (stream_mono, stream_dual) = translate_stream(stream=f.read(), **params)

⬆️ Volver arriba

HTTP

De una manera más flexible, puedes comunicarte con el programa utilizando protocolos HTTP, si:

1. Instalar y ejecutar el backend

pip install pdf2zh_next[backend]
pdf2zh_next --flask
pdf2zh_next --celery worker

1. Usar los protocolos HTTP de la siguiente manera:

2. Enviar tarea de traducción

   curl http://localhost:11008/v1/translate -F "[email protected]" -F "data={\"lang_in\":\"en\",\"lang_out\":\"zh\",\"service\":\"google\",\"thread\":4}"
   {"id":"d9894125-2f4e-45ea-9d93-1a9068d2045a"}
   

3. Verificar progreso

   curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a
   {"info":{"n":13,"total":506},"state":"PROGRESS"}
   

4. Verificar progreso (si está completado)

   curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a
   {"state":"SUCCESS"}
   

5. Guardar archivo monolingüe

   curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a/mono --output example-mono.pdf
   

6. Guardar archivo bilingüe

   curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a/dual --output example-dual.pdf
   

7. Interrumpir si está en ejecución y eliminar la tarea

   curl http://localhost:11008/v1/translate/d9894125-2f4e-45ea-9d93-1a9068d2045a -X DELETE
   

⬆️ Volver arriba