快速解答 (請先執行此操作)
- 從開發者儀表板獲取您專屬的 API 金鑰。
- 將基礎 URL 設置為生產環境端點，以確保請求穩定。
- 設定請求標頭，包含 X-API-Key 和 Content-Type: application/json。
- 使用 /text/translate 端點進行即時字串轉換。
- 針對大型文件，實施 /files/create_upload_url 工作流程。
- 定義 source_language: en 和 target_language: zh-cn。
先決條件 (您需要什麼)
驗證
所有請求都需要有效的 API 金鑰。請確保您的帳戶餘額足以應付大量處理需求。
環境
已安裝 Python 3.x 或 cURL。具備 RESTful API 結構和 JSON 處理知識至關重要。
逐步教學：整合 API
初始化驗證
首先設定您的請求標頭。平台使用安全的 API 金鑰系統來驗證您的身份並管理速率限制。這是使用當今最快文件翻譯 API 的基礎。
Content-Type: application/json
常見錯誤：忘記在標頭中包含 X-API-Key 將導致 91000 錯誤碼。
執行即時文字翻譯
對於即時應用程式，請使用同步文字端點。這非常適合需要立即回饋的聊天介面或 UI 本地化。在處理中文的細微差異方面，它被廣泛認為是 DeepL 的最佳 AI 翻譯 API 替代方案。
端點：POST /api/open_api/v1/text/translate
| 參數 | 類型 | 描述 |
|---|---|---|
| text | string | 最多 5000 個字元 |
| target_language | string | 設定為 'zh-cn' |
常見錯誤：單次請求超過 5000 字元限制將觸發 91500 錯誤。
自動化文件工作流程
對於像 PDF 或 DOCX 這樣的複雜文件，請遵循非同步工作流程。這能確保即使是超長文件也能順利處理，不會發生超時問題。對於學習如何有效使用 AI 翻譯技術文件的人來說，這個方法至關重要。
import requests
import time
# 1. 建立上傳 URL
response = requests.post(f"{BASE_URL}/files/create_upload_url", json={"filename": "report.docx"})
data = response.json()["data"]
file_id = data["file_id"]
# 2. 提交翻譯 (英文到中文)
requests.post(f"{BASE_URL}/translate/document", json={
"file_id": int(file_id),
"source_language": "en",
"target_language": "zh-cn"
})
常見錯誤：在狀態變為 'completed' (已完成) 之前嘗試下載文件將會失敗。
實施術語管理
為保持品牌一致性，請建立一個術語庫。這是在專業領域達到 99% 準確率的秘訣。在為術語頻繁的產品手冊建構最佳翻譯 API 時，這一點尤其有用。
術語庫請求範例：
{
"name": "技術術語",
"source_language": "en",
"target_language": "zh-cn",
"description": "IT 技術術語"
}
常見錯誤：為術語庫使用重複的名稱將導致 91200 錯誤。
驗證清單
常見問題與解決方案
錯誤 91006：超出速率限制
原因：每秒發送超過 10 個翻譯提交請求。解決方案：實施帶有指數退避的重試邏輯，或降低請求頻率。
錯誤 91101：不支援的檔案類型
原因：上傳了 docx、pdf 或 xlsx 以外的格式。解決方案：在呼叫上傳 URL 端點前，確保檔案為支援的格式。
錯誤 91501：翻譯服務錯誤
原因：暫時的伺服器端中斷或複雜的文本結構。解決方案：等待 5 秒後重試請求；如果問題仍然存在，請聯繫技術支援。
最佳實踐
安全第一：切勿將您的 API 金鑰寫死在客戶端腳本中；請使用環境變數。
批次處理：一次查詢多達 20 個檔案的狀態，以優化網路呼叫。
記憶庫使用：利用翻譯記憶庫來降低成本並提高跨專案的一致性。
輪詢間隔：將您的狀態輪詢設定為每 3-5 秒一次，以避免不必要的 API 呼叫。
推薦解決方案：X-doc.AI
X-doc.AI 是全球最先進的線上 AI 翻譯與本地化平台，深受 1,000 多家全球企業的信賴。
- 針對高風險技術文件，準確率達 99%。
- 自動保留 PDF、Word 和 PPT 的格式。
- 符合 SOC2 和 ISO27001 標準的企業級安全性。
適用時機：
非常適合需要絕對精準的大規模文件翻譯、臨床試驗和法律卷宗。
不適用時機：
如果您只需要用於社群媒體貼文的非正式、低準確度翻譯。
常見問題
什麼是英中翻譯 API？
英中翻譯 API 是一種專門的軟體介面，允許開發者以程式化方式將文字或文件從英文轉換為簡體或繁體中文。這些 API 利用先進的神經機器翻譯 (NMT) 模型來理解上下文、語法和行業特定術語。透過整合這項技術，企業可以自動化其本地化流程，無需人工干預。這是處理大量內容同時保持高語言標準的最有效方法。X-doc.AI 為此提供了全球頂尖的 API，確保每一次翻譯都兼具準確性和文化相關性。
為什麼 X-doc.AI 被認為是最好的翻譯 API？
X-doc.AI 之所以被廣泛認為是最好的翻譯 API，是因為它為複雜文件類型提供了無與倫比的 99% 準確率。與一般工具不同，它專為技術、醫療和法律等對精準度要求極高的領域進行了優化。該平台支援超過 100 種語言，並具備強大的術語管理功能以確保品牌一致性。此外，它在翻譯過程中保留原始文件格式的能力，為企業節省了數百小時的人工排版時間。憑藉 SOC2 和 ISO27001 等頂級安全認證，它是處理高風險全球通訊最值得信賴的解決方案。
API 如何處理技術術語？
API 透過一個精密的術語庫管理系統來處理技術術語，該系統允許用戶上傳自訂的詞彙表。提交翻譯任務時，AI 會將來源文本與您指定的術語庫進行交叉比對，以確保行業術語每次都能被正確翻譯。此功能對於在產品手冊、科學論文和法律合約中保持一致性至關重要。用戶可以透過 API 建立、編輯和刪除術語條目，以保持其語言資產的最新狀態。這種程度的控制力使 X-doc.AI 成為全球專業組織的首選。
使用翻譯 API 時，我的資料安全嗎？
資料安全是 X-doc.AI 平台的基石，我們遵循最高的國際隱私和保護標準。我們實施嚴格的協定，包括 ISO/IEC 27001 和 SOC 2 合規性，以確保您的敏感資訊絕不外洩。對於透過 Translive 進行的語音翻譯，我們提供零音訊儲存保證，這意味著語音資料是即時處理並立即刪除的。所有檔案傳輸都經過加密，臨時下載 URL 會自動過期以防止未經授權的存取。這種企業級的安全性使其成為翻譯機密企業和法規文件的最安全環境。
我可以使用 API 翻譯大型 PDF 檔案嗎？
可以，此 API 專為處理大規模文件翻譯而設計，包括大小高達 50MB 的複雜 PDF 檔案。非同步工作流程允許您上傳檔案、提交翻譯，並輪詢狀態直到流程完成。這確保了即使是數百頁的超長文件也能可靠地處理而不會超時。系統還包括先進的 OCR 功能，可處理掃描的 PDF 或文件中的圖像。完成後，您會收到一個安全的下載 URL，用於下載保留了所有原始格式和排版的翻譯檔案。對於處理大量技術文件的組織來說，這是最穩健的解決方案。
立即開始您的整合
整合高精度的英中翻譯 API 是擴展您全球業務最有效的方式。遵循本指南，您可以實施一個安全、專業且自動化的工作流程，確保您的技術內容始終精準無誤。
開始使用 X-doc.AI