APIS

Indice dei contenuti

Il presente progetto supporta due tipi di API, tutti i metodi necessitano di Redis;

• Chiamate funzionali in Python
• Protocolli HTTP

Python

Poiché pdf2zh è un modulo installato in Python, esponiamo due metodi che altri programmi possono chiamare in qualsiasi script Python.

Ad esempio, se desideri tradurre un documento dall'inglese al cinese utilizzando Google Translate, puoi utilizzare il seguente codice:

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)

⬆️ Torna all'inizio

HTTP

In un modo più flessibile, puoi comunicare con il programma utilizzando i protocolli HTTP, se:

1. Installa ed esegui il backend

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

1. Utilizza i protocolli HTTP come segue:

2. Invia un task di traduzione

   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. Controlla lo stato

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

4. Controlla lo stato (se completato)

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

5. Salva il file monolingue

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

6. Salva il file bilingue

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

7. Interrompi se in esecuzione ed elimina il task

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

⬆️ Torna all'inizio