DeepL (предварительная версия)
Соединитель DeepL предоставляет программный доступ к технологии машинного перевода DeepL, что позволяет обеспечить высокий уровень возможностей перевода непосредственно к веб-сайтам и приложениям. Если вы хотите разработать подключаемый модуль DeepL для вашего средства CAT, обратитесь к нам.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Тим Каденбах |
| URL | https://github.com/deejaytc |
| Адрес электронной почты | tim.cadenbach@deepl.com |
| Метаданные соединителя | |
|---|---|
| Publisher | DeepL |
| Website | https://www.deepl.com/ |
| Политика конфиденциальности | https://www.deepl.com/privacy/ |
| Категории | Данные |
Миссия DeepL состоит в том, чтобы преодолеть языковые барьеры и приблизить культуру друг к другу. Чтобы достичь этой миссии, мы используем наш опыт в искусственном интеллекте и нейронных сетях для создания технологий, которые обеспечивают взаимодействие быстрее, лучше и проще.
Соединитель API DeepL позволяет использовать API DeepL в потоках. Перевод текста или документов на лету или управление глоссариями. Любые функциональные возможности, которые мы предлагаем с ПОМОЩЬЮ API DeepL, также можно использовать в Power Automate.
Предварительные требования и учетные данные
Для использования соединителя требуется бесплатная подписка API DeepL или Pro. Вы можете зарегистрироваться здесь. После регистрации вы можете найти ключ проверки подлинности на вкладке "Учетная запись" в учетной записи API DeepL.
При создании потока вам будет предложено указать, есть ли у вас бесплатный или профессиональный план. Это должно быть выбрано соответствующим образом.
Начало работы с соединителем
Начните добавлять новый поток, как правило, и выберите один из доступных действий DeepL. Это впервые попросит вас добавить некоторые сведения о подключении, как показано ниже: 
Выберите тарифный план соответствующим образом и добавьте ключ API. Имя может быть любым нужным. Подтвердите шаг с помощью "Создать" и после этого можно использовать подключение для всех других доступных действий.
Известные проблемы и ограничения
Мы не можем автоматически обнаруживать ваш тарифный план. Вы должны выбрать между Free и Pro самостоятельно при настройке потока в первый раз.
Некоторые конечные точки не поддерживают JSON, но работают только с содержимым URLFormEncoded, и хотя соединитель имеет внутреннее решение, это может не всегда работать для всех.
Распространенные ошибки и средства устранения неполадок
HTTP 429 — ошибка 429 может быть вызвана несколькими проблемами: либо вы пытались вызвать API слишком часто, либо может возникнуть временная проблема в нашем конце. Общая рекомендация — использовать экспоненциальный подход обратного отключения и повторить вызов. Экспоненциальный обратный выход не реализуется самим соединителем.
HTTP 400 — что-то не так с вашим вызовом, полезными данными или параметрами, используемыми.
HTTP 456 — превышена квота. Если вы получите ошибку 456, ограничение учетной записи для символов достигнуто, и вам нужно дождаться следующего периода использования или обновить учетную запись. Если вы являетесь пользователем бесплатного API, вы можете обновить на вкладке "План" учетной записи.
Часто задаваемые вопросы
- Какова разница между планами Api DeepL Free и Pro?
Бесплатный API DeepL — это вариант плана DeepL API Pro, который позволяет переводить до 500 000 символов в месяц бесплатно.
Для более сложных потребностей план API DeepL Pro предлагает следующие дополнительные преимущества:
Максимальная безопасность данных (тексты удаляются сразу после перевода)
Нет ограничений на количество символов, которые можно перевести в месяц (модель выставления счетов на основе фиксированной цены 4,99 евро в месяц + затраты на основе использования в размере 0,00002 евро за переведенный символ)
Приоритетное выполнение запросов на перевод
Дополнительные сведения см. в нашем центре справки.
- Что делать, если я достигла предела для моего символа в плане "Бесплатный"?
Если вы достигли ежемесячного ограничения на API Deepl Free, вам придется ждать, пока следующий период использования (т. е. месяц) сможете использовать API еще раз. Кроме того, вы можете перейти на подписку Pro API на вкладке "План" учетной записи.
- Как подписчик Pro можно ограничить затраты на основе использования?
Да, вы можете активировать функцию управления затратами на вкладке "План" учетной записи Pro. Узнайте больше о контроле затрат в нашем центре справки.
- Какие функции доступны с помощью соединителя?
Все, что вы можете сделать с помощью нашего API, можно также использовать соединитель. Здесь можно просмотреть все поддерживаемые функциональные возможности и дополнительную документацию по параметрам и сведениям.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ API | securestring | Ключ API можно получить на панели мониторинга учетной записи. Требуется для пользователей Free и Pro. | True |
| Выбор плана | струна | Выберите у вас бесплатный или профессиональный пользователь API | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Вывод списка всех глоссарий |
Перечислить все глоссарии и их метаданные, но не записи глоссария. |
| Вывод списка языковых пар, поддерживаемых глоссариями |
Получите список языковых пар, поддерживаемых функцией глоссария. |
| Отправка и перевод документа |
Этот вызов отправляет документ и помещает его в очередь для перевода. |
| Перевод текста, используйте его для общего перевода текста |
Добавьте один или несколько текстовых записей для перевода, если они используются, они считаются одним и тем же контекстом. |
| Получение записей глоссария |
Вывод списка записей одного глоссария в формате, указанном заголовком |
| Получение поддерживаемых языков |
Получите список языков, которые в настоящее время поддерживаются для перевода в качестве исходного или целевого языка соответственно. |
| Получение сведений о глоссарии |
Извлеките метаданные для одного глоссария, не указывая записи глоссария. |
| Проверка использования и ограничений |
Получение сведений об использовании в течение текущего периода выставления счетов вместе с соответствующими ограничениями учетной записи. |
| Проверка состояния документа |
Получение текущего состояния процесса перевода документов. |
| Скачивание переведенного документа |
После завершения процесса |
| Создание глоссария |
Создание глоссария |
| Удаление глоссария |
Удаляет указанный глоссарий. |
Вывод списка всех глоссарий
Перечислить все глоссарии и их метаданные, но не записи глоссария.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Глоссарии
|
glossaries | array of Glossary |
Вывод списка языковых пар, поддерживаемых глоссариями
Получите список языковых пар, поддерживаемых функцией глоссария.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
supported_languages
|
supported_languages | array of object |
Список поддерживаемых языков |
|
source_lang
|
supported_languages.source_lang | string |
Язык, в котором указаны исходные тексты в глоссарии. |
|
target_lang
|
supported_languages.target_lang | string |
Язык, в котором указаны целевые тексты в глоссарии. |
Отправка и перевод документа
Этот вызов отправляет документ и помещает его в очередь для перевода.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Исходный язык
|
source_lang | string |
Язык переведенного текста |
|
|
Целевой язык
|
target_lang | True | string |
Язык, в который должен быть переведен текст |
|
Файл
|
file | True | file |
Преобразованный файл (.docx,.pptx,.pdf,.htm,.html,.txt ) |
|
Имя файла
|
filename | string |
Имя отправленного файла |
|
|
Формальность
|
formality | string |
Следует ли опираться на формальный или неофициальный язык. |
|
|
Идентификатор глоссария
|
glossary_id | string |
Уникальный идентификатор, назначенный глоссарию |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
document_id
|
document_id | string |
Уникальный идентификатор, назначенный отправленного документа и процесса перевода. |
|
document_key
|
document_key | string |
Уникальный ключ, используемый для шифрования отправленного документа, а также результирующего перевода на стороне сервера. |
Перевод текста, используйте его для общего перевода текста
Добавьте один или несколько текстовых записей для перевода, если они используются, они считаются одним и тем же контекстом.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Перевод текста
|
text | True | array |
Перевод текста. Поддерживается только обычный текст в кодировке UTF-8 |
|
Исходный язык
|
source_lang | string |
Язык переведенного текста |
|
|
Целевой язык
|
target_lang | True | string |
Язык, в который должен быть переведен текст |
|
Разделение предложений
|
split_sentences | string |
Разделение входных данных на предложения |
|
|
Сохранение форматирования
|
preserve_formatting | string |
Следует ли учитывать исходное форматирование |
|
|
Формальность
|
formality | string |
Следует ли опираться на формальный или неофициальный язык. |
|
|
Идентификатор глоссария
|
glossary_id | string |
Укажите глоссарий, используемый для перевода |
|
|
Обработка тегов
|
tag_handling | string |
Задает тип тегов, которые следует обрабатывать |
|
|
Не разделенные теги
|
non_splitting_tags | string |
Разделенный запятыми список XML-тегов, которые никогда не разделяют предложения |
|
|
Обнаружение структуры
|
outline_detection | string |
|
|
|
Разделение тегов
|
splitting_tags | string |
Разделенный запятыми список XML-тегов, которые всегда вызывают разделение |
|
|
Игнорировать теги
|
ignore_tags | string |
Разделенный запятыми список XML-тегов, указывающих, что текст не следует переводить |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Переводы
|
translations | array of object | |
|
detected_source_language
|
translations.detected_source_language | string |
Обнаруженный исходный язык. |
|
текст
|
translations.text | string |
Переведенный текст. |
Получение записей глоссария
Вывод списка записей одного глоссария в формате, указанном заголовком Accept .
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор глоссария
|
glossary_id | True | string |
Уникальный идентификатор, назначенный глоссарию |
|
Формат
|
Accept | string |
Сейчас поддерживается только |
Получение поддерживаемых языков
Получите список языков, которые в настоящее время поддерживаются для перевода в качестве исходного или целевого языка соответственно.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Тип
|
type | string |
Задает, должен ли быть указан исходный или целевой языки |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
|
array of object | ||
|
language
|
language | string |
Языковой код заданного языка. |
|
имя
|
name | string |
Имя языка на английском языке. |
|
supports_formality
|
supports_formality | boolean |
Обозначает поддержку формальности в случае перечисления целевого языка. |
Получение сведений о глоссарии
Извлеките метаданные для одного глоссария, не указывая записи глоссария.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор глоссария
|
glossary_id | True | string |
Уникальный идентификатор, назначенный глоссарию |
Возвращаемое значение
- Тело
- Glossary
Проверка использования и ограничений
Получение сведений об использовании в течение текущего периода выставления счетов вместе с соответствующими ограничениями учетной записи.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
character_count
|
character_count | integer |
Символы, переведенные до сих пор в текущий период выставления счетов. |
|
character_limit
|
character_limit | integer |
Текущее максимальное количество символов, которые можно перевести за период выставления счетов. |
|
document_limit
|
document_limit | integer |
Документы, переведенные до сих пор в текущий период выставления счетов. |
|
document_count
|
document_count | integer |
Текущее максимальное количество документов, которые можно перевести за период выставления счетов. |
|
team_document_limit
|
team_document_limit | integer |
Документы, переведенные всеми пользователями в команде до сих пор в текущий период выставления счетов. |
|
team_document_count
|
team_document_count | integer |
Текущее максимальное количество документов, которые могут быть переведены командой за период выставления счетов. |
Проверка состояния документа
Получение текущего состояния процесса перевода документов.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор документа
|
document_id | True | string |
Идентификатор документа был отправлен клиенту при отправке документа |
|
Ключ документа
|
document_key | True | string |
Ключ шифрования был отправлен клиенту при отправке документа |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
document_id
|
document_id | string |
Уникальный идентификатор, назначенный отправленного документа и запрошенный процесс перевода. Тот же идентификатор, который использовался при запросе состояния перевода. |
|
статус
|
status | string |
Краткое описание состояния процесса перевода документов в настоящее время. |
|
seconds_remaining
|
seconds_remaining | integer |
Предполагаемое количество секунд до завершения перевода.
Этот параметр включен только в то время как |
|
billed_characters
|
billed_characters | integer |
Количество символов, выставленных вашей учетной записи. |
|
error_message
|
error_message | string |
Краткое описание ошибки, если доступно. Обратите внимание, что содержимое подлежит изменению. Этот параметр может быть включен, если во время перевода произошла ошибка. |
Скачивание переведенного документа
После завершения процесса doneперевода документов можно скачать результат.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор документа
|
document_id | True | string |
Идентификатор документа был отправлен клиенту при отправке документа |
|
Ключ документа
|
document_key | True | string |
Ключ шифрования был отправлен клиенту при отправке документа |
Возвращаемое значение
- response
- binary
Создание глоссария
Создание глоссария
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя
|
name | True | string |
Имя, связанное с глоссарием |
|
Исходный язык
|
source_lang | True | string |
Язык, в котором указаны исходные тексты в глоссарии |
|
Целевой язык
|
target_lang | True | string |
Язык, в котором указаны целевые тексты в глоссарии |
|
Entries
|
entries | True | string |
Записи глоссария в формате, указанном в параметре |
|
Формат записей
|
entries_format | True | string |
|
Возвращаемое значение
- Тело
- Glossary
Удаление глоссария
Удаляет указанный глоссарий.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор глоссария
|
glossary_id | True | string |
Уникальный идентификатор, назначенный глоссарию |
Определения
ГлоссарийId
Уникальный идентификатор, назначенный глоссарию.
Уникальный идентификатор, назначенный глоссарию.
Glossary
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
glossary_id
|
glossary_id | GlossaryId |
Уникальный идентификатор, назначенный глоссарию. |
|
имя
|
name | string |
Имя, связанное с глоссарием. |
|
готовый
|
ready | boolean |
Указывает, можно ли использовать только что созданный глоссарий в |
|
source_lang
|
source_lang | GlossarySourceLanguage |
Язык, в котором указаны исходные тексты в глоссарии. |
|
target_lang
|
target_lang | GlossaryTargetLanguage |
Язык, в котором указаны целевые тексты в глоссарии. |
|
creation_time
|
creation_time | date-time |
Время создания глоссария в формате ISO 8601-1:2019 (например: |
|
entry_count
|
entry_count | integer |
Количество записей в глоссарии. |
ГлоссарияSourceLanguage
Язык, в котором указаны исходные тексты в глоссарии.
Язык, в котором указаны исходные тексты в глоссарии.
ГлоссарийTargetLanguage
Язык, в котором указаны целевые тексты в глоссарии.
Язык, в котором указаны целевые тексты в глоссарии.
бинарный
Это базовый тип данных binary.