DeepL (プレビュー)
DeepL コネクタを使用すると、DeepL の機械翻訳テクノロジにプログラムでアクセスできるため、高品質の翻訳機能を Web サイトやアプリケーションに直接提供できます。 CAT ツール用の DeepL プラグインを開発したい場合は、お問い合わせください。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Tim Cadenbach |
| URL | https://github.com/deejaytc |
| tim.cadenbach@deepl.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | DeepL |
| Web サイト | https://www.deepl.com/ |
| プライバシー ポリシー | https://www.deepl.com/privacy/ |
| カテゴリ | データ |
DeepLの使命は、言語の壁を克服し、文化を近づけすることです。 その使命を達成するために、人工知能とニューラル ネットワークに関する専門知識を使用して、通信をより迅速、より良く、簡単にするテクノロジを作成します。
DeepL API Connector を使用すると、フローで DeepL API を使用できます。 テキストやドキュメントをその場で翻訳したり、用語集を管理したりできます。 DeepL API で提供されるすべての機能は、Power Automate でも使用できます。
前提条件と資格情報
コネクタを使用するには、DeepL API Free または Pro サブスクリプションが必要です。 ここでサインアップできます。 サインアップ後、DeepL API アカウントの [アカウント] タブで認証キーを見つけることができます。
フローの作成時に、Free プランと Pro プランのどちらを使用するかを指定するように求められます。 これは、それに応じて選択する必要があります。
コネクタの概要
通常どおり新しいフローの追加を開始し、使用可能な DeepL アクションのいずれかを選択します。 これを初めて実行すると、次のように接続の詳細を追加するように求められます: 
それに応じて価格プランを選択し、API キーを追加します。 名前には、任意の名前を指定できます。 「作成」で手順を確認し、その後、使用可能な他のすべてのアクションに接続を使用できます。
既知の問題と制限事項
お客様の価格プランを自動検出することはできません。 初めてフローを設定するときは、Free と Pro のどちらかを自分で選択する必要があります。
一部のエンドポイントは JSON をサポートしていませんが、URLFormEncoded コンテンツでのみ機能します。コネクタには内部回避策がありますが、これは常にすべてのユーザーに対して機能するとは限りません。
一般的なエラーと解決方法
HTTP 429 - 429 エラーは、API を頻繁に呼び出そうとしたか、一時的な問題が発生している可能性がある複数の問題によって発生する可能性があります。 一般的な推奨事項は、指数バックオフ アプローチを使用し、呼び出しを再試行することです。 指数バックオフは、コネクタ自体では実装されません。
HTTP 400 - 使用されている呼び出し、ペイロード、またはパラメーターに問題がありました。
HTTP 456 - クォータを超えました。 456 エラーが発生した場合、アカウントの文字数制限に達しました。次の使用期間まで待つか、アカウントをアップグレードする必要があります。 Free API ユーザーの場合は、アカウントの [プラン] タブでアップグレードできます。
FAQ
- DeepL API Free プランと Pro プランの違いは何ですか?
DeepL API Free は、1 か月あたり最大 500,000 文字を無料で翻訳できる DeepL API Pro プランの一種です。
より高度なニーズに対応するために、DeepL API Pro プランには次の利点があります。
最大データ セキュリティ (翻訳の直後にテキストが削除されます)
1 か月あたりに翻訳できる文字数にボリューム制限はありません (1 か月あたり €4.99 の固定価格に基づく課金モデル + 翻訳された文字ごとに 0.00002 ユーロの使用量ベースのコスト)
翻訳要求の優先順位付けされた実行
- 無料プランの文字数制限に達した場合はどうなりますか?
Deepl API Free で毎月の文字数制限に達した場合は、次の使用期間 (つまり月) が API を再び使用できるようになるまで待つ必要があります。 または、アカウントの [プラン] タブで Pro API サブスクリプションへのアップグレードを検討することもできます。
- Pro サブスクライバーとして、使用量ベースのコストを制限する方法はありますか?
はい。 Pro アカウントの [プラン] タブからコスト管理機能をアクティブ化できます。 コスト管理の詳細については 、ヘルプ センターを 参照してください。
- コネクタを使用して使用できる機能はどれですか?
現在 API で実行できる操作は、コネクタを使用して行うことができます。 ここで 、サポート されているすべての機能と、パラメーターと詳細に関する追加のドキュメントを確認できます。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| API キー | securestring | API キーを使用すると、アカウント ダッシュボードからキーを取得できます。 Free および Pro ユーザーに必要です。 | 正しい |
| プランの選択 | 文字列 | お客様が API の無料またはプロのユーザーであることを選択してください | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| すべての用語集を一覧表示する |
用語集とそのメタ情報をすべて一覧表示しますが、用語集のエントリは一覧表示しません。 |
| サポートされている言語を取得する |
翻訳で現在サポートされている言語の一覧を、それぞれソース言語またはターゲット言語として取得します。 |
| テキストを翻訳し、一般的なテキスト翻訳に使用します |
翻訳する 1 つまたは複数のテキスト エントリを追加します。複数が使用されている場合は、同じコンテキストと見なされます。 |
| ドキュメントのアップロードと翻訳 |
この呼び出しはドキュメントをアップロードし、翻訳のためにキューに入れます。 |
| ドキュメントの状態を確認する |
ドキュメント翻訳プロセスの現在の状態を取得します。 |
| 使用状況と制限を確認する |
現在の請求期間内の使用状況情報を、対応するアカウント制限と共に取得します。 |
| 用語集でサポートされている言語ペアを一覧表示する |
用語集機能でサポートされている言語ペアの一覧を取得します。 |
| 用語集のエントリを取得する |
1 つの用語集のエントリを、 |
| 用語集の詳細を取得する |
用語集のエントリを省略して、1 つの用語集のメタ情報を取得します。 |
| 用語集を作成する |
用語集を作成する |
| 用語集を削除する |
指定した用語集を削除します。 |
| 翻訳された文書をダウンロードする |
ドキュメント翻訳プロセスの状態が |
すべての用語集を一覧表示する
用語集とそのメタ情報をすべて一覧表示しますが、用語集のエントリは一覧表示しません。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
用語 集
|
glossaries | array of Glossary |
サポートされている言語を取得する
翻訳で現在サポートされている言語の一覧を、それぞれソース言語またはターゲット言語として取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タイプ
|
type | string |
ソース言語とターゲット言語のどちらを一覧表示するかを設定します |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
言語
|
language | string |
指定された言語の言語コード。 |
|
名前
|
name | string |
英語の言語の名前。 |
|
supports_formality
|
supports_formality | boolean |
ターゲット言語リストの場合の形式のサポートを示します。 |
テキストを翻訳し、一般的なテキスト翻訳に使用します
翻訳する 1 つまたは複数のテキスト エントリを追加します。複数が使用されている場合は、同じコンテキストと見なされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
翻訳するテキスト
|
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 |
検出されたソース言語。 |
|
SMS 送信
|
translations.text | string |
翻訳されたテキスト。 |
ドキュメントのアップロードと翻訳
この呼び出しはドキュメントをアップロードし、翻訳のためにキューに入れます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ソース言語
|
source_lang | string |
翻訳するテキストの言語 |
|
|
目標言語
|
target_lang | True | string |
テキストを翻訳する言語 |
|
File
|
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 |
アップロードされたドキュメントの暗号化に使用される一意のキーと、サーバー側での結果の翻訳。 |
ドキュメントの状態を確認する
ドキュメント翻訳プロセスの現在の状態を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ドキュメント 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 |
エラーの簡単な説明 (使用可能な場合)。 コンテンツは変更される可能性があることに注意してください。 このパラメーターは、翻訳中にエラーが発生した場合に含まれる場合があります。 |
使用状況と制限を確認する
現在の請求期間内の使用状況情報を、対応するアカウント制限と共に取得します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
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 |
請求期間ごとにチームが翻訳できるドキュメントの現在の最大数。 |
用語集でサポートされている言語ペアを一覧表示する
用語集機能でサポートされている言語ペアの一覧を取得します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
supported_languages
|
supported_languages | array of object |
サポートされている言語の一覧 |
|
source_lang
|
supported_languages.source_lang | string |
用語集のソース テキストが指定されている言語。 |
|
target_lang
|
supported_languages.target_lang | string |
用語集のターゲット テキストが指定されている言語。 |
用語集のエントリを取得する
1 つの用語集のエントリを、 Accept ヘッダーで指定された形式で一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
用語集 ID
|
glossary_id | True | string |
用語集に割り当てられた一意の ID |
|
Format
|
Accept | string |
現在、サポートされているのは |
用語集の詳細を取得する
用語集のエントリを省略して、1 つの用語集のメタ情報を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
用語集 ID
|
glossary_id | True | string |
用語集に割り当てられた一意の ID |
戻り値
- Body
- Glossary
用語集を作成する
用語集を作成する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
名前
|
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 |
翻訳された文書をダウンロードする
ドキュメント翻訳プロセスの状態が doneされると、結果をダウンロードできます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ドキュメント ID
|
document_id | True | string |
ドキュメント ID は、ドキュメントのアップロード時にクライアントに送信されました |
|
ドキュメント キー
|
document_key | True | string |
暗号化キーは、ドキュメントのアップロード時にクライアントに送信されました |
戻り値
- response
- binary
定義
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
これは基本的なデータ型 'バイナリ' です。