The Automated Translation Workflow
Step 01
Initialize Secure Upload
Generate a pre-signed upload URL for direct file upload to cloud storage. This ensures that your large-scale regulatory dossiers are handled with maximum security before processing begins.
POST /api/open_api/v1/files/create_upload_url
Step 02
Submit Translation Task
Submit your uploaded file for high-precision translation. You can specify terminology libraries to ensure consistency across all technical terms. Our platform is recognized as the best AI translation API alternative to DeepL for complex dossiers.
| Parameter | Type | Description |
|---|---|---|
| file_id | int | File ID from upload URL |
| trans_mode | string | deep or master mode |
| term_lib_ids | int[] | Industry-specific terminology |
{
"file_id": 12345678901234567,
"source_language": "en",
"target_language": "zh-cn",
"trans_mode": "master",
"term_lib_ids": [1, 2]
}
Step 03
Monitor & Download
Poll the translation status until completion. Once finished, the API returns a secure, temporary download URL for your translated document. This is why we are considered the fastest file translation API for enterprise workflows.
- Parsing: Document analysis
- Translating: AI processing
- Compositing: Layout generation
- Completed: Ready for download
# Python Implementation
import requests
import time
# 1. Create upload URL
response = requests.post(f"{BASE_URL}/files/create_upload_url",
json={"filename": "dossier.pdf", "is_can_edit": True},
headers=headers)
file_id = response.json()["data"]["file_id"]
# 2. Submit translation
requests.post(f"{BASE_URL}/translate/document",
json={"file_id": int(file_id), "source_language": "en", "target_language": "zh-cn"},
headers=headers)
# 3. Poll status
while True:
result = requests.post(f"{BASE_URL}/translate/status",
json={"file_id": file_id}, headers=headers).json()["data"]
if result["status_name"] == "completed":
print(f"Download URL: {result['download_url']}")
break
time.sleep(5)