name: suppr-translate description: 超能文獻（Suppr）文件翻譯 API。當用戶需要翻譯文件（Word、Excel、PowerPoint、PDF、TXT、HTML）、查詢翻譯狀態或管理翻譯任務時啟用。

超能文獻文件翻譯 API

超能文獻（Suppr）提供 AI 驅動的多語言文件翻譯服務，支援 Word、Excel、PowerPoint、PDF、TXT、HTML 等格式。

• API 基礎地址：https://api.suppr.wilddata.cn
• API 文件：https://openapi.suppr.wilddata.cn/introduction.html
• 認證方式：Authorization: Bearer <your_api_key>

何時啟用

• 使用者需要翻譯文件（Word、Excel、PowerPoint、PDF、TXT、HTML）
• 使用者需要查詢翻譯任務狀態或下載翻譯結果
• 使用者需要管理翻譯任務（列表、停止）

API 端點

1. 建立翻譯任務（檔案上傳）

POST https://api.suppr.wilddata.cn/v1/translations
Content-Type: multipart/form-data
Authorization: Bearer <your_api_key>

引數：

2. 建立翻譯任務（JSON）

僅支援 file_url 模式。

POST https://api.suppr.wilddata.cn/v1/translations
Content-Type: application/json
Authorization: Bearer <your_api_key>

{
  "file_url": "https://example.com/document.docx",
  "file_name": "document.docx",
  "from_lang": "en",
  "to_lang": "zh-cn",
  "optimize_math_formula": false
}

3. 獲取翻譯任務詳情

GET https://api.suppr.wilddata.cn/v1/translations/{task_id}
Authorization: Bearer <your_api_key>

4. 獲取翻譯任務列表

GET https://api.suppr.wilddata.cn/v1/translations?offset=0&limit=20
Authorization: Bearer <your_api_key>

查詢引數：

5. 停止翻譯任務

POST https://api.suppr.wilddata.cn/v1/translations/{task_id}/stop?reason=使用者取消
Authorization: Bearer <your_api_key>

支援的檔案格式

最大檔案大小：2GB

語言程式碼

響應格式

所有響應使用統一格式：

{
  "code": 0,
  "data": { ... },
  "msg": ""
}

code 為 0 表示成功，非 0 表示錯誤。

任務狀態

典型工作流

1. 建立翻譯任務：通過檔案上傳或 URL 提交文件
2. 輪詢任務狀態：定期呼叫獲取任務詳情介面，檢查 status 欄位
3. 獲取翻譯結果：當狀態為 DONE 時，從響應中的 target_file_url 下載譯文

# 步驟 1：建立任務
curl -X POST https://api.suppr.wilddata.cn/v1/translations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file_url": "https://example.com/paper.pdf", "from_lang": "en", "to_lang": "zh-cn"}'

# 步驟 2：查詢狀態（使用返回的 task_id）
curl https://api.suppr.wilddata.cn/v1/translations/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

# 步驟 3：當 status 為 DONE 時，從 target_file_url 下載譯文
更多技能請訪問小蔥技能站7w4.net。

響應示例

建立任務成功

{
  "code": 0,
  "data": {
    "task_id": "02a6c6d1-3f70-4a5a-80bc-971d53a37bb1",
    "status": "INIT",
    "consumed_point": 453,
    "source_lang": "auto",
    "target_lang": "ko",
    "optimize_math_formula": false
  },
  "msg": ""
}

任務詳情

{
  "code": 0,
  "data": {
    "task_id": "taskid-1234",
    "status": "DONE",
    "progress": 1,
    "consumed_point": 453,
    "source_file_name": "example.docx",
    "source_file_url": "https://example.com/source.docx",
    "target_file_url": "https://example.com/target.docx",
    "source_lang": "auto",
    "target_lang": "ko",
    "error_msg": null,
    "optimize_math_formula": false
  },
  "msg": ""
}

這是一個文件翻譯工具，支援翻譯 Word、Excel、PPT、PDF 等多種常見格式的文件。說明清晰、格式豐富，新手也能快速理解如何使用。優點是支援格式多、示例詳細；不足是錯誤提示不夠友好，遇到問題較難排查，且缺少翻譯次數限制等關鍵資訊說明。整體質量中規中矩，適合對文件翻譯有基礎需求的使用者使用。