DeepLX

DeepLXとは何ですか?

DeepLX は、リバース エンジニアリングを通じて DeepL と同様の翻訳品質を提供する、無料の非公式 API です。これは、コストをかけずに高品質の翻訳サービスを必要とする開発者に、公式 DeepL API の代替手段を提供します。

柔軟なBaseURL構成

Read Frog は、さまざまな DeepLX プロバイダーと連携する柔軟な DeepLX BaseURL 構成をサポートしています。プロバイダー固有のエンドポイント形式に一致するように、baseURL をカスタマイズできます。

トークンプレースホルダーのサポート

BaseURL の {{apiKey}} プレースホルダーを使用して、任意の位置に API トークンを挿入できます。これは、異なる DeepLX プロバイダーが異なる URL 形式のトークンを必要とする場合に便利です。

例:

1. パス内のトークン: https://api.deeplx.com/{{apiKey}}/translate
2. クエリ パラメーターとしてのトークン: https://api.deeplx.com/v1/translate?token={{apiKey}}
3. サブドメインのトークン: https://{{apiKey}}.api.deeplx.com/translate

特別な URL の処理

標準 DeepLX URL

ほとんどの DeepLX プロバイダーでは、baseURL が /translate で終わらない場合、Read Frog が自動的にそれを追加します。

• 入力: https://deeplx.example.com
• 出力: https://deeplx.example.com/translate

API トークンの場合:

• 入力: https://deeplx.example.com + トークン abc123
• 出力: https://deeplx.example.com/abc123/translate

api.deeplx.org 特殊ロジック

公式 https://api.deeplx.org エンドポイントの場合、Read Frog は特別なロジックを適用して、.org と /translate の間に API トークンを挿入します。

• トークンなし: https://api.deeplx.org/translate
• トークンあり: https://api.deeplx.org/your-token/translate

構成例

API トークンは必要ありません

一部の DeepLX プロバイダーは認証を必要としません。

BaseURL: https://deeplx.vercel.app
API Key: (leave empty)
Result: https://deeplx.vercel.app/translate

パス内のトークン

BaseURL: https://api.deeplx.com/{{apiKey}}
API Key: your-secret-token
Result: https://api.deeplx.com/your-secret-token/translate

クエリパラメータとしてのトークン

BaseURL: https://api.example.com/v1/translate?key={{apiKey}}
API Key: your-api-key
Result: https://api.example.com/v1/translate?key=your-api-key

トークンを使用したカスタム エンドポイント

BaseURL: https://deeplx.mydomain.com/api/{{apiKey}}/translate
API Key: abc123
Result: https://deeplx.mydomain.com/api/abc123/translate

Read Frog での DeepLX のセットアップ

1. 拡張機能オプションを開く: Read Frog 拡張機能アイコンをクリックし、[オプション] に移動します。
2. API プロバイダーに移動します: API プロバイダー セクションに移動します
3. DeepLX を構成します:
   • プロバイダーの形式に従って BaseURL を設定します
   • 必要に応じて **API キー ** を追加します (プロバイダーが必要ない場合は空のままにしておきます)
   • カスタム トークンの配置が必要な場合は、{{apiKey}} プレースホルダーを使用してください
4. 翻訳のテスト: テキストを翻訳して、構成が機能することを確認してください。

一般的な DeepLX プロバイダー

無料プロバイダー (API キーなし)

• https://deeplx.vercel.app
• https://deeplx.herokuapp.com

有料/Self-hostedプロバイダー

• https://api.deeplx.org (API キーが必要)
• 独自の自己ホスト型インスタンス

トラブルシューティング

URL 構築の問題

URL の構築に問題がある場合:

1. baseURL 形式を確認してください: 予想されるパターンに従っていることを確認してください
2. トークンの配置を確認してください: {{apiKey}} が正しい位置にあることを確認してください
3. 最初にトークンを使用せずにテストしてください: 構成の問題を切り分けるために無料のプロバイダーを試してください

よくあるエラー

• 「{{apiKey}} プレースホルダーを使用する場合は API キーが必要です」: BaseURL で {{apiKey}} を指定しましたが、API キーを指定しませんでした
• 「DeepLX 変換リクエストが失敗しました」: BaseURL と API キーが正しいかどうかを確認してください
• ネットワーク エラー: DeepLX プロバイダーがアクセス可能でオンラインであることを確認してください。

API 応答フォーマット

DeepLX プロバイダーは、次の形式で JSON 応答を返す必要があります。

{
  "data": "translated text here"
}

独自の DeepLX インスタンスを設定している場合は、この期待される形式で応答が返されることを確認してください。