Операции перевода документов
Справочная
функция: перевод документов в Azure AI Translator →
Перевод документов — это облачная функция службы Azure AI Translator и является частью семейства служб ИИ Azure REST API. API перевода документов пакетной службы преобразует документы на все поддерживаемые языки и диалекты , сохраняя структуру документов и формат данных. Доступные методы перечислены в следующих таблицах:
Версия API: 2024-05-01
Примечание.
Текущая версия является обратно совместимой с устаревшей версией.
Начиная с текущей версии
get supported storage sourcesметод больше не поддерживается. Служба переводчика поддерживает только хранилище BLOB-объектов Azure.
| Запросить | Метод | Description | Путь к API |
|---|---|---|---|
| Один | Синхронный | Документ | Перевод |
| Перевод документа | POST | Синхронно перевод одного документа. | {document-translation-endpoint}/translator/document:translate?targetLanguage={target_language}&api-version={date} |
| Пакетная обработка | Асинхронный | Документы | Перевод |
| Запуск перевода | 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 |
Устарело
Примечание.
- Устаревшая версия совместима с текущей версией. Для перевода документов можно использовать операции любой версии.
- Мы рекомендуем перенести приложения в последнюю версию, чтобы воспользоваться расширенным интерфейсом и расширенными возможностями.
| Запросить | Метод | Description | Путь к API |
|---|---|---|---|
| Один | Синхронный | Документ | Перевод |
| Перевод документа | 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}" |
| Пакетная обработка | Асинхронный | Документы | Перевод |
| Запуск перевода | 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 | Запросите список поддерживаемых источников и параметров хранилища. В настоящее время служба Переводчика поддерживает только хранилище BLOB-объектов Azure. | {document-translation-endpoint}.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources |