DeepL/deepl-python

DeepL Python Library

무엇인가요 – DeepL API의 공식 Python 클라이언트로, 고품질 기계 번역, 텍스트 개선(재구성), 문서 번역을 제공하는 상용 언어 AI 서비스입니다.

주요 기능

• 텍스트 번역 – translate_text()는 단일 문자열 또는 리스트를 수신하고, 자동으로 원본 언어를 감지하며, 번역된 텍스트와 메타데이터(감지된 원본 언어, 청구 대상 문자 수, 사용된 모델)를 반환합니다. 문장 분할, 공손함 수준, 용어집, 사용자 지정 지시사항, 모델 유형(품질 최적화 vs. 지연 최적화), 태그 처리(HTML/XML) 등을 제어할 수 있는 옵션이 있습니다.
• 작성/개선 API – rephrase_text()는 동일 언어 내 텍스트를 재작성하거나 개선하거나, 언어 변형(예: 미국 영어 vs. 영국 영어)을 변경할 수 있습니다. 학술적, 비즈니스적, 캐주얼, 단순한 스타일 또는 자신감 있는, 외교적인 등 다양한 톤을 요청할 수 있습니다.
• 문서 번역 – translate_document() / translate_document_from_filepath()는 DOCX, PDF 등 전체 파일을 업로드하고, 상태를 휠링한 후 번역된 버전을 다운로드합니다. 또한 하위 수준의 업로드/상태 확인/다운로드 함수를 직접 호출할 수도 있습니다.
• 용어집 – 새 v3 엔드포인트를 통해 다국어 용어집(사용자 정의 용어 매핑)을 생성, 목록 조회, 조회, 삭제할 수 있습니다. 용어집은 직접 제공하거나 CSV 파일에서 업로드할 수 있습니다.
• 고급 기능 – 번역 메모리, 스타일 규칙, 사용자 지정 지시사항(1회 요청당 최대 10개), 세밀한 XML 태그 처리(분할, 무시 등).

일반적인 사용 예시

import deepl
client = deepl.DeepLClient("YOUR_AUTH_KEY")
# 간단한 텍스트 번역
result = client.translate_text("Hello, world!", target_lang="FR")
print(result.text)   # → Bonjour, le monde !

# 비즈니스 스타일로 영어 텍스트 재구성
improved = client.rephrase_text(
    "A rainbouw has seven colours.",
    target_lang="EN-US",
    style=deepl.WritingStyle.BUSINESS.value,
)
print(improved.text)

설치 및 요구 사항

• pip install --upgrade deepl로 설치 (Python 3.9–3.13 지원).
• requests (≥ 2.32.4)에 의존합니다. Ubuntu 22.04에서는 python3-cachecontrol 패키지가 필요할 수 있습니다.

누가 사용할까 – 번역 기능을 갖춘 앱, 로컬라이제이션 파이프라인, 콘텐츠 생성 도구, 또는 DeepL의 번역 또는 텍스트 개선 기능을 프로그래밍 방식으로 호출해야 하는 서비스를 개발하는 개발자.

---

위의 모든 정보는 리포지토리의 README에서 직접 인용되었습니다.