05-deepl-python.md

05 · DeepL HTTP API · official Python SDK

Drives translate --serve with the real deepl Python SDK by overriding server_url.

Generated by scripts/generate-examples.py from a live translate install. Each output below is the real captured stdout — none of it is hand-written.

deepl.Translator.get_target_languages() -- the official Python SDK

import deepl
t = deepl.Translator("any-token", server_url="http://127.0.0.1:52537")
langs = t.get_target_languages()
print(f"got {len(langs)} target languages, first three: {[l.code for l in langs[:3]]}")

got 33 target languages, first three: ['AR', 'BG', 'CS']

exit code: 0

deepl.Translator.get_usage() -- quota check via the SDK

import deepl
t = deepl.Translator("any-token", server_url="http://127.0.0.1:52537")
u = t.get_usage()
print(f"character_count={u.character.count} character_limit={u.character.limit}")

character_count=0 character_limit=1000000000

exit code: 0

deepl.Translator.translate_text() -- single string, drop-in usage

import deepl
t = deepl.Translator("any-token", server_url="http://127.0.0.1:52537")
r = t.translate_text("Hallo Welt.", source_lang="DE", target_lang="EN-US")
print("text:", r.text)
print("detected_source_lang:", r.detected_source_lang)

text: Hello world.
detected_source_lang: DE

exit code: 0

deepl.Translator.translate_text() -- list batch

import deepl
t = deepl.Translator("any-token", server_url="http://127.0.0.1:52537")
rs = t.translate_text(["Hallo", "Welt", "Guten Morgen"],
                      source_lang="DE", target_lang="EN-US")
for r in rs: print(r.text)

Hello
World
Good morning

exit code: 0