注册开发者并获取 API Key
提供用于文档翻译的RESTful API，支持自动化翻译任务管理、基于术语表的术语一致性，以及对支持格式、语言和模型的查询，便于构建无缝翻译工作流程和管理用户账户。
入门指南
要开始使用，您需要申请成为开发者。申请成为开发者
一旦获得批准，您可以创建多个API密钥，并根据需要在每个API请求中包含相应的API密钥。
快速接入
基础 URL
https://dltranslator.com/api
认证方式
Authorization: [yourSecretKey]
JSON 请求
除文件上传接口外，接口默认使用 POST JSON 请求，Content-Type 为 application/json。
文件上传
创建文档翻译任务使用 multipart/form-data，file 字段传入待翻译文件。
通用错误响应
请求失败时接口会返回 JSON，error 字段包含固定英文错误信息。建议优先按 HTTP status code 分支处理错误，error 字段用于展示或日志记录。
{
"error": "Invalid API key."
}错误状态码规则
所有 v1 API 错误响应保持相同结构，请按下列 HTTP status code 规则处理。
- 400 Bad Request
- 缺少必需参数、参数格式或枚举值无效、缺少文件上传、上传保存失败或任务处理失败。
- 401 Unauthorized
- 缺少 API 密钥或 API 密钥无效。
- 402 Payment Required
- 积分余额不足，无法进行预览、完整翻译或文本翻译。
- 404 Not Found
- 该任务或术语表不存在、已被删除、不属于当前API账户，或者不是通过API创建的。
- 409 Conflict
- 当前任务状态不允许请求的操作。
- 500 Internal Server Error
- 意外的服务器异常。响应错误固定为"内部服务器错误"。
推荐接入流程
1. 创建任务
上传文件并创建翻译任务，返回 taskId。
2. 查询进度
轮询任务状态，直到 Completed、Terminated 或 Cancelled。
3. 获取结果
下载译文文件，或读取原文和译文 JSON。
4. 管理任务
按需支付全文翻译、重启任务、修订文本或删除任务。