文档翻译 REST API 指南（2024-05-01）

旧版文档翻译 REST API（版本 2024-05-01）支持同步单文档翻译、异步批处理翻译和发现操作。同步翻译在不Blob 存储的情况下处理单个文档，并直接返回翻译的文件。异步批处理翻译处理存储在Azure Blob 存储中的一个或多个文档，并允许你轮询状态。

所有请求都需要自定义域终结点。格式为 https://{your-resource-name}.cognitiveservices.azure.cn/。

注意

同步操作

Operation	方法	说明	Reference
翻译文档	`POST`	翻译单个文档并在响应中接收翻译的输出。无需Blob 存储。	同步文档翻译

Operation	方法	说明	Reference
开始批量翻译	`POST`	提交一个或多个文档以进行异步翻译。文档必须位于Azure Blob 存储中。返回作业 ID。	开始批量翻译
获取翻译状态	`GET`	检索特定批处理作业的总体状态和文档摘要。轮询到作业达到终端状态。	获取翻译状态
获取所有翻译的状态	`GET`	列出提交到资源的所有批处理翻译作业。支持筛选和分页。	获取所有翻译作业的状态
获取所有文档状态	`GET`	检索特定作业中所有文档的每文档状态。	获取所有文档的状态
获取特定文档的状态	`GET`	检索作业中单个文档的状态和输出详细信息。	获取特定文档的状态
取消翻译	`DELETE`	取消排队或正在进行中的作业。	取消翻译

Operation	方法	说明	Reference
获取支持的文档格式	`GET`	检索受支持的文档格式及其 MIME 类型的列表。	获取支持的文档格式
获取支持的词汇表格式	`GET`	检索支持的术语表格式及其 MIME 类型的列表。	获取支持的术语表格式

前面的 v1.1 API 支持路径下的 /translator/text/batch/v1.1 异步批处理和发现操作。该 Get supported storage sources 操作仅在 v1.1 中可用。翻译器支持Azure Blob 存储作为存储源。

建议将现有应用程序迁移到最新的 API 版本，以使用当前功能。

Operation	方法	API 路径
开始批量翻译	`POST`	`/translator/text/batch/v1.1/batches`
获取所有翻译作业的状态	`GET`	`/translator/text/batch/v1.1/batches`
获取特定翻译作业的状态	`GET`	`/translator/text/batch/v1.1/batches/{id}`
获取所有文档状态	`GET`	`/translator/text/batch/v1.1/batches/{id}/documents`
获取特定文档的状态	`GET`	`/translator/text/batch/v1.1/batches/{id}/documents/{documentId}`
取消翻译	`DELETE`	`/translator/text/batch/v1.1/batches/{id}`
获取支持的文档格式	`GET`	`/translator/text/batch/v1.1/documents/formats`
获取支持的词汇表格式	`GET`	`/translator/text/batch/v1.1/glossaries/formats`
获取支持的存储源	`GET`	`/translator/text/batch/v1.1/storagesources`