APIS

Table des matières

Le projet actuel prend en charge deux types d'APIs, toutes les méthodes nécessitent Redis ;

• Appels fonctionnels en Python
• Protocoles HTTP

Python

Comme pdf2zh est un module installé en Python, nous exposons deux méthodes pour que d'autres programmes puissent les appeler dans n'importe quel script Python.

Par exemple, si vous souhaitez traduire un document de l'anglais vers le chinois en utilisant Google Translate, vous pouvez utiliser le code suivant :

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)

⬆️ Retour en haut

HTTP

De manière plus flexible, vous pouvez communiquer avec le programme en utilisant les protocoles HTTP, si :

1. Installer et exécuter le backend

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

1. Utiliser les protocoles HTTP comme suit :

2. Soumettre une tâche de traduction

   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. Vérifier la progression

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

4. Vérifier la progression (si terminé)

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

5. Sauvegarder le fichier monolingue

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

6. Sauvegarder le fichier bilingue

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

7. Interrompre si en cours et supprimer la tâche

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

⬆️ Retour en haut