DeepL （预览版）
DeepL 连接器提供对 DeepL 机器翻译技术的编程访问，使可以将高质量的翻译功能直接引入网站和应用程序。 如果要为 CAT 工具开发 DeepL 插件，请与我们联系。
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| Name | 蒂姆·卡登巴赫 |
| URL | https://github.com/deejaytc |
| tim.cadenbach@deepl.com |
| 连接器元数据 | |
|---|---|
| 发布者 | DeepL |
| 网站 | https://www.deepl.com/ |
| 隐私策略 | https://www.deepl.com/privacy/ |
| 类别 | Data |
DeepL 的使命是克服语言障碍，使文化更加紧密。 为了实现这一任务，我们使用我们在人工智能和神经网络方面的专业知识来创建技术，使通信更快、更好、更轻松。
DeepL API 连接器允许在流中使用 DeepL API。 即时翻译文本或文档或管理词汇表。 我们向 DeepL API 提供的任何功能也可以在 Power Automate 中使用。
先决条件和凭据
若要使用连接器，需要 DeepL API 免费订阅或 Pro 订阅。 可以在此处注册。 注册后，可以在 DeepL API 帐户的“帐户”选项卡中找到身份验证密钥。
创建流时，系统会要求你指定是有免费计划还是专业计划。 必须相应地选择此项。
连接器入门
开始像往常一样添加新流，并选择其中一个可用的 DeepL作。 首次执行此作将要求添加一些连接详细信息，如下所示： 
相应地选择价格计划并添加 API 密钥。 名称可以是所需的任何内容。 使用“创建”确认步骤，并在之后对可用的所有其他作使用连接。
已知问题和限制
我们无法自动检测你的价格计划。 首次设置流时，必须在“免费”和“专业”之间进行选择。
某些终结点不支持 JSON，但仅适用于 URLFormEncoded 内容，尽管连接器有内部解决方法，但这可能并不总是适用于所有人。
常见错误和补救措施
HTTP 429 - 429 错误可能是由多个问题引起的：要么你尝试调用 API 的频率过高，要么我们末尾可能存在临时问题。 一般建议使用指数退避方法，然后重试调用。 连接器本身未实现指数退避。
HTTP 400 - 调用、有效负载或参数出现问题。
HTTP 456 - 超出配额。 如果收到 456 错误，则已达到字符的帐户限制，需要等到下一个使用期或升级帐户。 如果你是免费 API 用户，则可以 在帐户的“计划”选项卡中升级。
FAQ
- DeepL API Free 和 Pro 计划之间的区别是什么？
DeepL API Free 是 DeepL API Pro 计划的一个变体，可让你每月免费翻译最多 500,000 个字符。
对于更高级的需求，DeepL API Pro 计划提供以下附加优势：
最大数据安全性（翻译后立即删除文本）
对每月可以翻译的字符数没有数量限制（基于固定价格每月 4.99 英镑的计费模型 + 每个翻译字符 0.00002 欧元）
优先执行翻译请求
- 如果我达到免费计划的字符限制，该怎么办？
如果已达到 Deepl API Free 的每月字符限制，则必须等到下一个使用周期（即月份）才能再次使用该 API。 或者，可以考虑在帐户的“计划”选项卡中升级到 Pro API 订阅。
- 作为 Pro 订阅者，是否有办法限制基于使用情况的成本？
是的，可以从 Pro 帐户的“计划”选项卡激活成本控制功能。 在 帮助中心 了解有关成本控制的详细信息。
- 使用连接器提供哪些功能？
你当前可以使用连接器完成对 API 执行的任何作。 可 在此处 查看所有受支持的功能和有关参数和详细信息的其他文档。
正在创建连接
连接器支持以下身份验证类型：
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用：所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| API 密钥 | securestring | API 密钥，可以从帐户仪表板获取密钥。 免费用户和 Pro 用户需要。 | True |
| 计划选择 | 字符串 | 请选择你是 API 的免费用户或专业用户 | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 上传和翻译文档 |
此调用上传文档并将其排队以供翻译。 |
| 下载已翻译的文档 |
文档翻译过程 |
| 列出所有术语表 |
列出所有术语表及其元信息，但不包括术语表条目。 |
| 列出术语表支持的语言对 |
检索术语表功能支持的语言对列表。 |
| 创建术语表 |
创建术语表 |
| 删除术语表 |
删除指定的术语表。 |
| 检查使用情况和限制 |
检索当前计费周期内的使用情况信息以及相应的帐户限制。 |
| 检查文档状态 |
检索文档翻译过程的当前状态。 |
| 检索支持的语言 |
检索当前支持翻译的语言列表，分别作为源语言或目标语言。 |
| 检索术语表条目 |
以标头指定的格式列出单个术语表的 |
| 检索术语表详细信息 |
检索单个术语表的元信息，省略术语表条目。 |
| 翻译文本，将其用于常规文本翻译 |
添加一个或多个要翻译的文本条目（如果使用多个条目），则它们被视为同一上下文。 |
上传和翻译文档
此调用上传文档并将其排队以供翻译。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
源语言
|
source_lang | string |
要翻译的文本的语言 |
|
|
目标语言
|
target_lang | True | string |
文本应翻译到的语言 |
|
文件
|
file | True | file |
要翻译的文件（.docx、.pptx、.pdf、.htm 、.html、.txt） |
|
文件名
|
filename | string |
上传的文件的名称 |
|
|
礼节
|
formality | string |
是倾向于正式语言还是非正式语言。 |
|
|
术语表 ID
|
glossary_id | string |
分配给术语表的唯一 ID |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
document_id
|
document_id | string |
分配给上传的文档和翻译过程的唯一 ID。 |
|
document_key
|
document_key | string |
用于加密上传的文档以及服务器端生成的翻译的唯一密钥。 |
下载已翻译的文档
文档翻译过程 done的状态完成后，可以下载结果。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文档 ID
|
document_id | True | string |
上传文档时，文档 ID 已发送到客户端 |
|
文档密钥
|
document_key | True | string |
上传文档时，加密密钥已发送到客户端 |
返回
- response
- binary
列出所有术语表
列出所有术语表及其元信息，但不包括术语表条目。
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
词汇 表
|
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 |
指定术语表中的目标文本的语言。 |
创建术语表
创建术语表
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Name
|
name | True | string |
要与术语表关联的名称 |
|
源语言
|
source_lang | True | string |
指定术语表中的源文本的语言 |
|
目标语言
|
target_lang | True | string |
指定术语表中目标文本的语言 |
|
Entries
|
entries | True | string |
参数中指定的格式的 |
|
条目格式
|
entries_format | True | string |
|
返回
- Body
- Glossary
删除术语表
删除指定的术语表。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
术语表 ID
|
glossary_id | True | string |
分配给术语表的唯一 ID |
检查使用情况和限制
检索当前计费周期内的使用情况信息以及相应的帐户限制。
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
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 |
团队每个计费周期可以翻译的当前最大文档数。 |
检查文档状态
检索文档翻译过程的当前状态。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文档 ID
|
document_id | True | string |
上传文档时，文档 ID 已发送到客户端 |
|
文档密钥
|
document_key | True | string |
上传文档时，加密密钥已发送到客户端 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
document_id
|
document_id | string |
分配给上传的文档和请求的翻译过程的唯一 ID。 请求翻译状态时使用的相同 ID。 |
|
状态
|
status | string |
文档翻译过程当前处于状态的简短说明。 |
|
seconds_remaining
|
seconds_remaining | integer |
在翻译完成之前估计的秒数。
此参数仅在 |
|
billed_characters
|
billed_characters | integer |
向帐户计费的字符数。 |
|
error_message
|
error_message | string |
错误的简短说明（如果可用）。 请注意，内容可能会更改。 如果在翻译期间发生错误，可以包含此参数。 |
检索支持的语言
检索当前支持翻译的语言列表，分别作为源语言或目标语言。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
类型
|
type | string |
设置是否应列出源或目标语言 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
|
array of object | ||
|
语言
|
language | string |
给定语言的语言代码。 |
|
姓名
|
name | string |
英语语言的名称。 |
|
supports_formality
|
supports_formality | boolean |
表示目标语言列表时的形式支持。 |
检索术语表条目
以标头指定的格式列出单个术语表的 Accept 条目。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
术语表 ID
|
glossary_id | True | string |
分配给术语表的唯一 ID |
|
Format
|
Accept | string |
目前仅支持 |
检索术语表详细信息
翻译文本，将其用于常规文本翻译
添加一个或多个要翻译的文本条目（如果使用多个条目），则它们被视为同一上下文。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
要翻译的文本
|
text | True | array |
要翻译的文本。 仅支持 UTF-8 编码纯文本 |
|
源语言
|
source_lang | string |
要翻译的文本的语言 |
|
|
目标语言
|
target_lang | True | string |
文本应翻译到的语言 |
|
拆分句子
|
split_sentences | string |
是否将输入拆分为句子 |
|
|
保留格式
|
preserve_formatting | string |
是否尊重原始格式 |
|
|
礼节
|
formality | string |
是倾向于正式语言还是非正式语言。 |
|
|
术语表 ID
|
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 |
翻译的文本。 |
定义
GlossaryId
术语表
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
glossary_id
|
glossary_id | GlossaryId |
分配给术语表的唯一 ID。 |
|
姓名
|
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 |
术语表中的条目数。 |
GlossarySourceLanguage
GlossaryTargetLanguage
二进制
这是基本数据类型“binary”。