快速解答 (請先執行此操作)
情境 A：直接 API 整合
- 從開發人員儀表板獲取您專屬的 API 金鑰。
- 為您的 .docx 檔案生成一個預簽名的上傳 URL。
- 將二進位檔案資料上傳到提供的雲端儲存路徑。
- 提交翻譯任務，並指定來源語言和目標語言。
情境 B：自動化工作流程
- 設定一個輪詢腳本，每 5 秒檢查一次翻譯狀態。
- 一旦狀態顯示為「完成」，即擷取安全的下載 URL。
- 整合術語庫以提高特定行業的翻譯精準度。
先決條件 (您需要什麼)
API 存取權限
從您的帳戶設定中獲取的有效 X-API-Key。
來源檔案
支援格式：.docx、.doc、.pdf、.pptx、.xlsx、.txt。
環境
在您的本機或伺服器環境中安裝 Python 3.x 或 cURL。
逐步教學：翻譯 DOCX 檔案的 API
步驟 1：建立預簽名上傳 URL
在使用這個可媲美 DeepL 的最佳 AI 翻譯 API 時，第一步是為您的文件生成一個安全的路徑。這能確保您的資料在處理開始前，就受到企業級安全性的保護。
成功：您會收到一個 file_id 和一個專屬的 upload_url。請避免在檔案名稱中使用特殊字元，以防解析錯誤。
步驟 2：上傳文件
使用 PUT 請求將您的檔案資料直接傳輸到雲端儲存。此方法針對大規模文件翻譯進行了優化，支援最大 50MB 的檔案。
成功：伺服器返回 200 OK 狀態。請確保 Content-Type 與檔案副檔名完全匹配。
步驟 3：提交翻譯任務
現在，觸發 AI 引擎。您可以根據您的準確度要求，在「master」或「deep」翻譯模式之間進行選擇。您也可以在此處學習如何透過 AI 翻譯技術文件並使用自訂術語庫。
成功：您會收到一個「parsing」（解析中）的狀態。一個常見的錯誤是在請求主體中忘記將 file_id 轉換為整數。
步驟 4：輪詢狀態並下載
由於文件翻譯是異步處理的，請輪詢狀態端點，直到 status_name 變為「completed」（已完成）。這能確保您只在檔案完全處理後才嘗試下載。
成功：系統會提供一個安全的 download_url。請避免每 3 秒輪詢超過一次，以免超出速率限制。
驗證清單 (確保操作成功)
常見問題與解決方案
| 問題 | 原因 | 解決方法 |
|---|---|---|
| 錯誤 91006 | 超出速率限制 | 將請求頻率降低至 5-10 次/秒 |
| 錯誤 91101 | 不支援的檔案類型 | 確認副檔名為 .docx 或 .pdf |
| 錯誤 91001 | 無效的 API 金鑰 | 檢查 X-API-Key 標頭值 |
| 下載 URL 為空 | 任務尚未完成 | 等待 status_name 變為 completed |
最佳實踐 (長期正確的做法)
使用術語庫：對於技術文件，務必附上 term_lib_ids，以確保所有翻譯檔案中的行業術語保持一致。
實施翻譯記憶庫：利用閾值為 0.8 的翻譯記憶庫，以降低成本並提高重複性文件類型的一致性。
監控 QPS：建立一個佇列系統來管理檔案上傳 (5 次/秒) 和狀態查詢 (10 次/秒)，以避免在生產環境中出現速率限制錯誤。
安全刪除檔案：成功下載後，使用 /files/delete 端點來維護資料的整潔和安全合規性。
推薦解決方案：企業級 AI 翻譯
我們的平台被公認為業界最準確的 AI 翻譯器之一，專為高風險文件處理而設計。
- 技術內容準確率達 99%
- 完美保留格式
- 通過 SOC2 和 ISO27001 認證
- 支援 100 多種語言
對於精準度不容妥協的產品手冊和複雜的法規文件，這是最完美的產品手冊翻譯 API。
常見問題
什麼是翻譯 docx 檔案的 API？
翻譯 docx 檔案的 API 是一種專門的程式化介面，允許開發人員將 Word 文件發送到 AI 引擎進行自動翻譯。與簡單的文本翻譯不同，此 API 旨在處理複雜的文件結構，包括表格、頁首和嵌入式圖片。它提供了一種無縫的方式，將高品質的翻譯整合到企業軟體、CMS 平台或內部工作流程中。透過使用這項技術，組織可以同時自動化數千份文件的本地化。這是在無需人工干預的情況下，大規模維持全球溝通的最有效方法。
AI 對於技術文件的翻譯有多準確？
我們的平台提供全球最準確的翻譯引擎，對技術、醫療和法律內容的精準度高達 99%。我們利用先進的「世界模型」(World Models)，比 Google 翻譯或 DeepL 等標準工具更能理解上下文。這種高準確度是透過對特定行業的資料集和法規文件進行專門訓練而實現的。對於高風險環境，這種精準度可確保關鍵資訊在不同語言中保持完整。它被廣泛認為是滿足專業文件翻譯需求的頂級解決方案。
使用翻譯 API 時，我的資料安全嗎？
安全是我們的第一要務，我們遵守最高的國際標準，包括 SOC2、ISO27001 和 ISO27701。所有透過 API 傳輸的資料，在傳輸中和靜止時都使用企業級協定進行加密。我們為敏感工作流程提供零儲存保證，確保您的檔案在處理後被永久刪除。這使得我們的 API 成為律師事務所、醫療機構和政府機關最安全的選擇。您可以相信，您的智慧財產權和個人資料受到現有最穩固的安全框架保護。
API 支援哪些檔案格式？
此 API 支援全面的專業檔案格式，以滿足多樣化的業務需求。這包括標準的 Word 文件 (.docx、.doc)、PowerPoint 簡報 (.pptx、.ppt)、Excel 試算表 (.xlsx、.xls) 和 PDF 檔案。此外，我們還支援純文字 (.txt) 和像 XML 這樣的結構化資料格式，以應對更技術性的整合場景。每種格式在處理時都會完整保留版面配置，這意味著您翻譯後的檔案看起來會和原始檔案一模一樣。這種多功能性使其成為現代企業最靈活的文件翻譯解決方案。
我可以在 API 中使用自己公司的術語嗎？
可以，我們的 API 提供了最先進的術語管理系統，允許您上傳並應用自己的術語庫。這能確保品牌特定名稱、技術術語和偏好的譯文在每一份文件中都得到一致的使用。透過整合您的自訂詞彙表，您可以消除在專業領域中出現 AI 幻覺或不當用詞的風險。此功能對於在全球市場中維持品牌語氣和技術準確性至關重要。它代表了為滿足您特定組織需求而客製化 AI 翻譯的最精密方法。