文档翻译 API

POST /v2/document

概述

上传并翻译整个文档，保留原始格式。支持 PDF、DOCX、PPTX、XLSX、HTML、TXT、IDML、XLIFF、JSON 等格式。异步处理：上传后轮询状态，完成后下载译文。

使用流程

1. POST /v2/document — 上传源文件，返回 document_id 和 document_key
2. POST /v2/document/{document_id} — 轮询翻译状态（translating / done / error）
3. POST /v2/document/{document_id}/result — 下载翻译完成的文件

请求参数

• file (file, 必填): 要翻译的文件。支持格式和大小限制见帮助中心文档。
• target_lang (string, 必填): 目标语言代码。
• source_lang (string, 可选): 源语言代码。
• filename (string, 可选): 输出文件名。
• formality (enum): more / less / default / prefer_more / prefer_less。
• glossary_id (string): 术语表 ID。
• glossary_ids (string[]): 最多 5 个术语表 ID。

响应

上传成功后返回:

{
  "document_id": "abc123",
  "document_key": "xyz789",
  "status": "queued"
}

状态查询返回:

{
  "document_id": "abc123",
  "status": "done",
  "seconds_remaining": 0,
  "billed_characters": 5000
}

文件格式与大小限制

• Word (.docx / .doc): 最大 30MB
• PowerPoint (.pptx / .ppt): 最大 30MB
• Excel (.xlsx / .xls): 最大 30MB
• PDF: 最大 30MB (Pro) / 10MB (Free)
• HTML: 最大 5MB
• TXT: 最大 1MB
• IDML: 最大 30MB
• XLIFF 2.1: 最大 30MB
• JSON: 最大 30MB

翻译完成后保留原始文档的格式和布局。