DeepLXは、Cloudflare Workers上にデプロイされたサーバーレス(Serverless)アプリケーションで、ユーザーにDeepLとGoogle翻訳サービスへの無料かつ高性能なインターフェースを提供します。このプロジェクトは、インテリジェントなプロキシルーティング、高度なレート制限アルゴリズム、およびメルトダウンメカニズムによって、従来の翻訳APIを使用する際によく見られるHTTP 429(リクエストが多すぎる)エラーを効果的に解決します。公式APIと比較して、DeepLXはより高いリクエストレート制限と低いネットワーク遅延を提供します。APIキーやライセンス料が不要で完全に無料であるため、ユーザーは1回の導入で翻訳機能に無制限にアクセスできます。また、このプロジェクトは高い安定性と複数のセキュリティ機能を備えており、開発者と一般ユーザーに信頼性の高い低コストの翻訳ソリューションを提供することを目指しています。
参考プロジェクト:https://github.com/OwO-Network/DeepLX
機能一覧
- マルチ翻訳サービス対応また、DeepL (
/deepl)とグーグル翻訳(/google)の2つの主流翻訳エンジン。 - ハイパフォーマンスCloudflare Workersをベースとしたグローバル・エッジ・ネットワークの展開により、低レイテンシーとゼロ・コールドスタートでの応答性を実現。
- 高い要求レベルインテリジェントなロードバランシングと複数のプロキシエンドポイントにより、公式APIよりも高い同時リクエストをサポートします。
- 高い安定性フュージョン・メカニズムと指数関数的なバックオフ・リトライ戦略により、故障したプロキシ・エンドポイントを自動的に検出して切り替え、ほぼ完全に回避することができる。
429サービスの継続性を確保するためのエラー。 - スマートキャッシュ内蔵メモリとKVストレージの二層キャッシュシステムにより、同じコンテンツに対する翻訳要求の繰り返しを効果的に減らし、効率を向上させることができます。
- 完全無料APIキーの申請、利用料、利用制限はありません。
- 安全性入力検証、多次元レート制限、CORSサポート、セキュリティヘッダなどの機能により、安全でセキュアなサービスを保証します。
- 統合が容易様々なアプリケーションに簡単に統合できるように、複数のプログラミング言語(cURL、JavaScript、Python)による詳細なAPIドキュメントと使用例を提供します。
ヘルプの使用
DeepLXには、作者が事前に配備したパブリック・サービス・アドレスを直接使用する方法と、ユーザーが自分の手でCloudflareアカウントに配備する方法がある。
1.クイック・スタート(公共サービスの利用)
ほとんどの利用者にとって、公式に提供されている公共サービスを直接利用するのが最も簡単で早い方法である。
公共サービス演説: https://dplx.xi-xu.me
適切なパスにPOSTリクエストを送ることで、翻訳関数を呼び出すことができます。
コード例
リクエスト・ヘッダは、リクエスト時に指定する必要がある。 Content-Type: application/jsonそして、翻訳するテキスト、ソース言語、ターゲット言語をリクエスト本文に含める。
cURLの例。
- DeepLを使用して翻訳されています(推奨)。
curl -X POST https://dplx.xi-xu.me/deepl \
-H "Content-Type: application/json" \
-d '{
"text": "Hello, world!",
"source_lang": "EN",
"target_lang": "ZH"
}'
- グーグル翻訳を使う
curl -X POST https://dplx.xi-xu.me/google \
-H "Content-Type: application/json" \
-d '{
"text": "Hello, world!",
"source_lang": "EN",
"target_lang": "ZH"
}'
JavaScriptの例。
async function translateWithDeepL(text, sourceLang = 'auto', targetLang = 'zh') {
const response = await fetch('https://dplx.xi-xu.me/deepl', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
text: text,
source_lang: sourceLang,
target_lang: targetLang
})
});
const result = await response.json();
return result.data;
}
// 调用示例
translateWithDeepL('Hello, world!', 'en', 'zh')
.then(result => console.log(result))
.catch(error => console.error(error));
Python の例。
import requests
import json
def translate_with_deepl(text, source_lang='auto', target_lang='zh'):
url = 'https://dplx.xi-xu.me/deepl'
data = {
'text': text,
'source_lang': source_lang,
'target_lang': target_lang
}
response = requests.post(url, json=data)
result = response.json()
if result['code'] == 200:
return result['data']
else:
raise Exception(f"Translation failed: {result.get('message', 'Unknown error')}")
# 调用示例
try:
result = translate_with_deepl('Hello, world!', 'en', 'zh')
print(result)
except Exception as e:
print(f"Error: {e}")
2.サードパーティツールとの統合
DeepLX は、多くの主要な翻訳ツールや学術ツールに簡単に統合できます。 以下に、いくつかの一般的なツールの構成を示します:
- Pot (クロスプラットフォームの単語翻訳ソフトウェア)
- Potをダウンロードしてインストールする。
- ポットのサービス設定にアクセスする。
- DeepL サービス・タイプを以下のように構成します。
DeepLXに設定し、カスタムURLをhttps://dplx.xi-xu.me/deepl.
- Zotero(文書管理ツール)
- Zoteroをインストールする。
- Translate for Zoteroプラグインをダウンロードしてインストールします。
- Zotero設定の「Translations」タブで、次のように翻訳サービスを設定します。
DeepLX (API). - Configure ボタンをクリックして、エンドポイントを
https://dplx.xi-xu.me/deepl.
- Immersive Translate (Immersive Translateブラウザプラグイン)
- プラグインをインストールした後、"Developer Settings "でベータテストを有効にしてください。
- 翻訳サービスにカスタム翻訳サービスを追加する
DeepLX. - APIのURLを次のように設定する。
https://dplx.xi-xu.me/deepl. - 1秒あたりの最大リクエスト数」を
80リクエストごとの最大テキスト長」を5000最適なパフォーマンスのために。
3.自己配備
より高いデータプライバシー要件がある場合や、より安定したサービスをご希望の場合は、以下の手順に従って、DeepLXをご自身のCloudflareアカウントに導入できます。
前提条件:
- Cloudflareのアカウント。
- Node.js 18+がインストールされている。
- Wrangler CLI(Cloudflare用コマンドラインツール)がインストールされています。
配備プロセス:
- クローン倉庫
git clone https://github.com/xixu-me/DeepLX.git cd DeepLX - 依存関係のインストール
npm install - 設定環境
のプロジェクト・ルート・ディレクトリを開く。wrangler.jsoncファイルを修正してください。account_id歌で応えるname(労働者の申請名)。{ "account_id": "你的CLOUDFLARE_ACCOUNT_ID", "name": "你的WORKER名称", ... } - KV名前空間の作成
DeepLX は、キャッシュとレート制限に KV ストレージを使用します。2 つの KV ネームスペースを作成する必要があります。# 创建缓存 KV npx wrangler kv:namespace create "CACHE_KV" # 创建速率限制 KV npx wrangler kv:namespace create "RATE_LIMIT_KV"コマンド実行後、返される
idに更新された。wrangler.jsoncドキュメンテーションkv_namespacesパート - Cloudflareへのデプロイ
# 部署到生产环境 npx wrangler deploy展開に成功すると、独自の DeepLX サービス・アドレスが取得されます。
アプリケーションシナリオ
- 個人および開発者向け翻訳ツールの統合
ユーザーは、DeepLXをバックエンドサービスとして、チャットボットやコンテンツアグリゲータなど、自由なテキスト翻訳機能のために開発するアプリケーション、スクリプト、またはボットに統合できます。 - 学術研究と文献の読解
外国語の文献をたくさん読む必要がある学生や研究者のために、DeepLXをZotero、PDF翻訳ツール(PDFMathTranslateなど)、その他のソフトウェアに統合して、PDF文書や学術論文のワンクリック翻訳を実現できます。 - クロスプラットフォームのデスクトップアプリケーション
DeepLXをバックエンドAPIとして使用することで、Pot、Bobなどのクロスプラットフォームのデスクトップ翻訳ソフトウェアをサポートし、ユーザーがいつでも簡単にコンピュータでテキストを翻訳できるようになります。 - ブラウザ・ウェブ翻訳
を使用する。 没入型翻訳 DeepLXのサービスアドレスをブラウザのプラグインに設定することで、ユーザーは外国語のウェブサイトを閲覧する際、スムーズで自由なバイリンガル翻訳体験を楽しむことができる。
品質保証
- HTTP 429 (too many requests) エラーが発生するのはなぜですか?
これは、プロキシエンドポイントの設定が正しくないか、不十分であることが原因である可能性があります。プロキシエンドポイントのPROXY_URLS環境変数が正しく設定されている。最高のパフォーマンスを得るためには、できるだけ多くの XDPL エージェントのインスタンスをデプロイして追加することをお勧めします。また、XDPL エージェントの新しいインスタンスをsrc/lib/config.tsファイルでレート制限設定を調整する。 - 翻訳結果が不正確な理由は何ですか?
まず、提供したソース言語とターゲット言語のコードが正しいことを確認してください。ソース言語が自動検出 (AUTO)、入力されたテキストがサービスによって正確に認識されるのに十分な長さであることを確認してください。さらに、テキストがエンコードされている形式も、翻訳の品質に影響を与える可能性があります。 - もし自己配備が失敗したら?
デプロイは通常いくつかの理由で失敗します: まず、CloudflareアカウントIDがwrangler.jsoncファイルが正しく記入されていることを確認する。CACHE_KV歌で応えるRATE_LIMIT_KV最後に、ネットワーク環境がCloudflareサービスに正しくアクセスできることを確認します。 - DeepLX と公式の DeepL API の違いは何ですか?
DeepL公式APIは有料で、リクエスト頻度の制限が厳しい。DeepLXは完全に無料で、ロードバランシングとマルチプロキシメカニズムにより、より高いリクエストレート上限とより低いレイテンシを提供し、インテリジェントな再試行とメルトダウンによりサービスの安定性を確保します。






























