翻译任务 API
查询翻译任务
查询翻译任务的状态和详情。
- 完整地址
- https://otranslator.com/api/v1/translation/query
- 认证
- 需要在 Authorization 请求头中传入 API Key
- Content-Type
- application/json
- 错误格式
- { "error": "Invalid API key." }
注意事项
建议在任务状态为 Waiting 或 Processing 时轮询该接口，状态进入 Completed、Terminated 或 Cancelled 后停止轮询。
下载链接为临时访问地址，请在业务侧按需保存文件或重新查询获取。
示例
1curl -X POST 'https://otranslator.com/api/v1/translation/query' \
2--header 'Authorization: [yourSecretKey]' \
3--header 'Content-Type: application/json' \
4--data '{
5 "taskId": "[string]"
6}'请求参数
| 参数 | 类型 | 默认 | 描述 | 示例 |
|---|---|---|---|---|
| *taskId | String | - | 翻译任务ID | - |
响应
| 参数 | 类型 | 默认 | 描述 | 示例 |
|---|---|---|---|---|
| taskId | String | - | 任务ID | - |
| model | String | - | 翻译时使用的模型 | - |
| fromLang | String | - | 原语言 | - |
| toLang | String | - | 目标语言 | - |
| status | String | - | 状态: '初始化' | '等待中' | '处理中' | '已完成' | '已终止' | '已取消' | - |
| progress | Number | - | 进度，0~100 | - |
| errorMsg | String | - | 错误信息 | - |
| fileTitle | String | - | 原文件名 | - |
| fileUrl | String | - | 原文件下载地址 | - |
| translatedFileUrl | String | - | 译文的下载地址 | - |
| translatedBilingualFileUrl | String | - |
| - |
| translatedEditableFileUrl | String | - | 可编辑译文文件下载地址。仅在对应文件类型生成可编辑结果时返回。 | - |
| tokenCount | Integer | - |
| - |
| wordNums | Integer | - | 文档统计词数。不同文件类型可能为空。 | - |
| price | Integer | - | 整体翻译所需的Credits数 | - |
| usedCredits | Integer | - | 翻译任务已使用的Credits数 | - |
| glossary | String[] | - | 翻译任务使用的术语表名称 | - |
| shouldTranslateImage | Boolean | - | 是否翻译文档中的图片 | - |
| forceOCR | Boolean | - | 是否强制使用 OCR 识别文档内容 | - |
| createdAt | DateTime | - | 翻译任务的创建时间 | - |
| updatedAt | DateTime | - | 翻译任务的更新时间 | - |
常见错误
401 Missing API key.
The Authorization request header is required.
401 Invalid API key.
The API key does not exist, has been deleted, or is no longer valid.
400 Missing required parameter: taskId.
Provide the taskId returned by the create translation task API.
404 Task not found.
The task does not exist, has been deleted, does not belong to the current API account, or was not created through the API.