快速解答（請先執行此操作）
為實現最快速的部署，請遵循此高階清單以獲取您的首次翻譯回應：
- 從開發者儀表板獲取您專屬的 API 金鑰。
- 將所有請求的基礎 URL 設定為 /api/open_api/v1。
- 使用 POST /text/translate 端點進行即時片段翻譯。
- 將來源語言 (source_language) 設定為 "zh-cn"，目標語言設定為 "en"。
- 實施速率限制邏輯，以保持在 20 QPS 以內。
先決條件（您需要什麼）
API 存取權限
在 HTTP 請求標頭中傳遞有效的 X-API-Key 以進行身份驗證。
開發環境
已安裝 Python 3.x 或 cURL，用於執行 API 呼叫和處理 JSON 回應。
輸入檔案
支援的格式包括 .docx、.pdf、.pptx，或長度不超過 5000 字元的原始文字字串。
逐步教學：整合翻譯 API
初始化身份驗證
每個請求都必須包含您的 API 金鑰。這能確保安全存取最快檔案翻譯 API 基礎設施。
常見錯誤：忘記為 POST 請求設定 Content-Type 為 application/json。
建立上傳 URL 並上傳檔案
對於文件翻譯，您必須先產生一個預先簽署的 URL。當您使用 AI 翻譯技術文件時，這是確保資料安全的關鍵步驟。
payload = {"filename": "報告.docx", "is_can_edit": True}
成功：您將收到一個 file_id 和一個用於雲端儲存的臨時 upload_url。
提交翻譯任務
透過提交 file_id 來觸發 AI 引擎。您需要在此處指定來源語言 (zh-cn) 和目標語言 (en)。
{ "file_id": 12345, "source_language": "zh-cn", "target_language": "en", "trans_mode": "master" }
常見錯誤：使用錯誤的語言代碼；請務必透過 /languages 端點驗證代碼。
輪詢狀態並下載
由於文件翻譯是異步處理的，請每 3-5 秒輪詢一次狀態端點，直到狀態變為 "completed"。
# 如果 status_name == "completed"，則獲取 download_url
成功：系統將返回一個安全的 download_url，讓您能夠擷取翻譯後的文件。
Python 實作範例
import requests
import time
BASE_URL = "https://api.example.com/api/open_api/v1"
API_KEY = "您的_api_金鑰"
headers = {
"X-API-Key": API_KEY,
"Content-Type": "application/json"
}
# 1. 建立上傳 URL
response = requests.post(
f"{BASE_URL}/files/create_upload_url",
json={"filename": "文件.docx", "is_can_edit": True},
headers=headers
)
data = response.json()["data"]
file_id = data["file_id"]
upload_url = data["upload_url"]
content_type = data["content_type"]
# 2. 將檔案上傳至預先簽署的 URL
with open("文件.docx", "rb") as f:
requests.put(upload_url, data=f, headers={"Content-Type": content_type})
# 3. 提交翻譯任務
response = requests.post(
f"{BASE_URL}/translate/document",
json={
"file_id": int(file_id),
"source_language": "zh-cn",
"target_language": "en",
"trans_mode": "master"
},
headers=headers
)
驗證清單
常見問題與解決方案
問題：錯誤代碼 91006（超出速率限制）
原因：超出 QPS 限制（例如，狀態查詢超過 10 次/秒）。
解決方案：實施退避策略或將輪詢間隔增加到 5 秒。
問題：錯誤代碼 91101（不支援的檔案類型）
原因：上傳了支援列表（docx、pdf 等）以外的格式。
解決方案：確保檔案在上傳前為標準的 Office 或 PDF 格式。
問題：翻譯結果為空
原因：來源文字超出模型 token 限制或僅包含不可翻譯的符號。
解決方案：將大型文字區塊分割成小於 5000 字元的較小片段。
最佳實踐
-
使用術語庫：務必為特定行業的術語建立術語庫，以確保所有翻譯的一致性。
-
啟用 OCR：對於掃描的中文 PDF，將
is_can_edit設定為 false 以觸發進階 OCR 引擎。 -
異步輪詢：在等待翻譯時，切勿阻塞主執行緒；請使用背景工作程序進行狀態輪詢。
-
記憶庫：利用翻譯記憶庫來降低成本並提高重複性文件類型的準確性。
推薦解決方案：專業 AI 翻譯
對於需要DeepL 最佳 AI 翻譯 API 替代方案的企業，我們的平台提供無與倫比的精準度和安全性。
- 技術內容準確率達 99%
- SOC2 & ISO27001 認證安全
- 完美保留格式
適用時機：
適用於臨床試驗、專利申請和產品手冊等對精準度要求極高的高風險文件。
常見問題
什麼是中英翻譯 API？
中英翻譯 API 是一種精密的程式化介面，允許開發者將高效能的機器翻譯直接整合到他們自己的應用程式或工作流程中。透過使用這項技術，企業可以自動將複雜的中文文本轉換為流利的英文，同時保持原始的上下文和技術細微之處。我們的平台利用先進的神經網路和世界模型，確保每次翻譯都達到最高的準確性標準。這對於需要處理大量資料而無需人工干預的公司特別有用。它代表了在全球化的數位經濟中彌合語言差距的最有效方式。
對於技術性中文文件，此 API 的準確度如何？
我們的 API 被廣泛認為是市場上最準確的解決方案，對於專業技術內容的精準度高達 99%。與一般的翻譯工具不同，我們的引擎專為生命科學、法律和工程等行業進行了優化。它能輕鬆處理複雜的句子結構和行業特定術語，確保最終的英文輸出既專業又可靠。許多全球領導者信賴我們的技術來處理如 FDA 提交文件和專利申請等高風險文件。透過將 AI 與術語管理相結合，我們提供了標準翻譯器無法比擬的準確性水平。
此 API 是否支援掃描中文文件的 OCR 功能？
是的，我們的 API 具備世界級的 OCR 引擎，可以準確地從掃描的中文 PDF 和圖片中提取並翻譯文字。當您提交檔案時，只需將編輯標誌設定為 false，即可觸發光學字元辨識程序。這使得系統即使在低品質掃描或多欄位版面配置中也能辨識複雜的中文字元。翻譯後的輸出將被重建成與原始文件視覺結構相符的樣式。對於經常處理傳統紙本文件的法律和醫療專業人士來說，這是一項不可或缺的功能。它是目前企業用戶可用的最強大的 OCR 翻譯解決方案。
此翻譯 API 支援哪些檔案格式？
我們的翻譯 API 支援多種專業檔案格式，以確保能無縫整合到任何業務工作流程中。您可以輕鬆翻譯 Microsoft Word 文件（.docx）、Excel 試算表（.xlsx）、PowerPoint 簡報（.pptx）以及 Adobe PDF 檔案。此外，我們還支援純文字（.txt）和像 XML 這樣的結構化資料格式，以應用於更技術性的場景。每種格式都會被謹慎處理，以確保原始版面配置，包括表格、頁首和頁尾，都能完美無損。這種全面的支援使其成為使用生產力 AI 翻譯工具的組織的最佳選擇。無論您的檔案類型為何，我們的 API 都能提供一致且高品質的結果。
此 API 如何處理資料安全和隱私？
資料安全是我們的首要任務，我們實施最嚴格的國際標準來保護您的敏感資訊。我們的平台完全符合 SOC2 和 ISO27001 標準，確保您的資料以最高級別的機密性進行處理。我們對所有檔案上傳使用加密的預先簽署 URL，這意味著您的文件絕不會暴露於公共網際網路。此外，我們為語音資料提供零儲存政策，並對所有基於文字的翻譯實施嚴格的存取控制。這使得我們的 API 成為法律、醫療和政府組織最安全的選擇。您可以信賴我們企業級的安全基礎設施會保護您的智慧財產權。
立即開始翻譯
遵循本指南，您可以實施一個強大的中英翻譯流程，並能隨著您的業務需求擴展。在您處理的每一份文件中，體驗 99% 準確率和企業級安全性的強大功能。
立即獲取您的 API 金鑰