超能文献文档翻译 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 下载译文

响应示例

创建任务成功

{
  "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": ""
}