參考
功能： Azure 翻譯器→文件翻譯
文件轉換是 Azure Translator 的雲端功能，屬於 Foundry 工具家族的 REST API 之一。 批次文件翻譯 API 能在保留文件結構與資料格式的同時，將所有 支援語言與方言 的文件進行翻譯。 可用的方法會列在下表中：
API 版本： 2024-05-01
注意
目前的版本與舊版回溯相容。
從目前版本及後續版本，此
get supported storage sources方法已不再支援。 Translator 僅支援 Azure Blob 儲存。
| 要求 | 方法 | 描述 | API 路徑 |
|---|---|---|---|
| Single | 同步 | Document | 翻譯 |
| 翻譯檔 | POST | 同步翻譯單一文件。 | {document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date} |
| Batch | 非同步 | 文件 | 翻譯 |
| 開始翻譯 | POST | 啟動批次文件翻譯作業。 | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| 取得所有翻譯作業的狀態 | GET | 要求使用者提交的翻譯工作清單和狀態。 | {document-translation-endpoint}/translator/document/batches?api-version={date} |
| 取得特定翻譯作業的狀態 | GET | 要求特定翻譯作業狀態的摘要。 回應包含整體作業狀態，以及正在轉譯為該作業一部分的文件狀態。 | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| 取得所有文件的狀態 | GET | 要求翻譯作業中所有文件的狀態。 | {document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date} |
| 取得特定文件的狀態 | GET | 要求作業中特定文件的狀態。 | {document-translation-endpoint}/translator/document/batches/{id}/documents/{documentId}?api-version={date} |
| 取消翻譯 | DELETE | 取消目前正在處理或排隊中的文件翻譯工作。 | {document-translation-endpoint}/translator/document/batches/{id}?api-version={date} |
| 取得支援的檔案格式 | GET | 要求支援的檔案格式清單。 | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=document |
| 取得支援的詞彙格式 | GET | 要求支援的詞彙格式清單。 | {document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary |
舊版
注意
- 舊版與目前版本回溯相容。 您可以使用任一版本的作業來翻譯檔。
- 建議您將應用程式移轉至最新版本，以受益於增強的體驗和進階功能。
| 要求 | 方法 | 描述 | API 路徑 |
|---|---|---|---|
| Single | 同步 | Document | 翻譯 |
| 翻譯檔 | POST | 同步翻譯單一文件。 | {document-translation-endpoint}/translator/document:translate?sourceLanguage={source language}&targetLanguage={target language}&api-version=2024-05-01" -H "Ocp-Apim-Subscription-Key:{your-key}" -F "document={path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -F "glossary={path-to-your-glossary-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file}" |
| Batch | 非同步 | 文件 | 翻譯 |
| 開始翻譯 | POST | 啟動批次文件翻譯作業。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| 取得所有翻譯作業的狀態 | GET | 要求使用者提交的翻譯工作清單和狀態。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches |
| 取得特定翻譯作業的狀態 | GET | 要求特定翻譯作業狀態的摘要。 回應包含整體作業狀態，以及正在轉譯為該作業一部分的文件狀態。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| 取得所有文件的狀態 | GET | 要求作業中特定文件的狀態。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents |
| 取得特定文件的狀態 | GET | 要求作業中特定文件的狀態。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}/documents/{documentId} |
| 取消翻譯 | DELETE | 取消目前正在處理或排隊中的文件翻譯工作。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id} |
| 取得支援的檔案格式 | GET | 要求支援的檔案格式清單。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats |
| 取得支援的詞彙格式 | GET | 要求支援的詞彙格式清單。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats |
| 取得支援的記憶體來源 | GET | 要求支援的記憶體來源/選項清單。 目前，Translator 僅支援 Azure Blob 儲存。 | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources |