translatenets 0.1.0

Python client for the TranslateNets API.

TranslateNets Python SDK

Python client for the TranslateNets API: translate text, images (PNG, JPEG, WebP), and Word documents (.docx).

Requirements: Python 3.10+

Install

pip install translatenets

Authentication

Create an API key at translatenets.com/dashboard/api-keys and set TRANSLATENETS_API_KEY, or pass api_key= to Translator.

Usage

import os

from translatenets.client import Translator

t = Translator(api_key=os.environ["TRANSLATENETS_API_KEY"])

# Text — returns JSON from the API (e.g. translated fields)
t.translateText("Hello, world!", target_language="jp")

# Image — path to PNG/JPEG/WebP; response includes a data URL under `image`
t.translateImage("/path/to/image.png", target_language="jp")

# Optional: write translated binary to disk (same idea for documents)
t.translateImage("/path/to/image.png", target_language="jp", save_path="/path/to/out.png")

# Document — `.docx` only, max 20 MB per file
t.translateDocument("/path/to/doc.docx", target_language="jp", save_path="/path/to/out.docx")

# Supported language codes (also available programmatically)
t.getLanguages()  # e.g. "en", "jp"

Optional arguments on translate methods:

• source_language — omit for auto-detection where supported.
• provider — one of grok, openai, claude, gemini (default on the client is grok).

Limits: text input up to 80,000 characters; images up to 10 MB.

Contributing

1. Get an API key from TranslateNets and copy .env.example to .env with TRANSLATENETS_API_KEY set.

2. Clone the repo and install with uv:

   git clone https://github.com/TranslateNets/translatenets-python.git
   cd translatenets-python
   uv sync --group dev
   

3. Run tests:

   uv run pytest