APIS

Índice

O presente projeto suporta dois tipos de APIs, todos os métodos precisam do Redis;

• Chamadas funcionais em Python
• Protocolos HTTP

Python

Como pdf2zh é um módulo instalado em Python, expomos dois métodos para que outros programas possam chamar em qualquer script Python.

Por exemplo, se você deseja traduzir um documento do inglês para o chinês usando o Google Tradutor, você pode usar o seguinte 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)

⬆️ Voltar ao topo

HTTP

De uma forma mais flexível, você pode se comunicar com o programa usando protocolos HTTP, se:

1. Instalar e executar o backend

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

1. Usar os protocolos HTTP conforme a seguir:

2. Enviar tarefa de tradução

   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 progresso

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

4. Verificar progresso (se concluído)

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

5. Salvar arquivo monolíngue

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

6. Salvar arquivo bilíngue

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

7. Interromper se estiver em execução e excluir a tarefa

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

⬆️ Voltar ao topo