如何整合法文文件翻譯 API（逐步教學）

建立預簽名上傳 URL

在您上傳法文文件之前，必須請求一個安全的臨時 URL。這能確保您的資料以企業級的安全性進行處理。對於掃描文件，請記得設定 OCR 參數。

成功：您會收到一個 file_id 和一個唯一的 upload_url。

提交翻譯任務

文件上傳後，觸發翻譯引擎。您需要在此處指定來源語言為法文。整合DeepL 的最佳 AI 翻譯 API 替代方案，可以實現更卓越的上下文處理能力。

常見錯誤：使用錯誤的 ISO 代碼。法文請務必使用 "fr"。

Python 實作範例

使用此 Python 腳本自動化整個工作流程。它處理了實現最快文件翻譯 API 性能所需的提交和輪詢邏輯。

import requests
import time

# 提交法文文件的翻譯任務
response = requests.post(
    f"{BASE_URL}/translate/document",
    json={
        "file_id": int(file_id),
        "source_language": "fr",
        "target_language": "en",
        "trans_mode": "master"
    },
    headers=headers
)

# 輪詢狀態直到完成
while True:
    status_resp = requests.post(
        f"{BASE_URL}/translate/status",
        json={"file_id": file_id},
        headers=headers
    )
    result = status_resp.json()["data"]
    if result["status_name"] == "completed":
        print(f"Download URL: {result['download_url']}")
        break
    time.sleep(5)