DeepL 翻訳 (Text Translation)¶
1. 概要 (Overview)¶
DeepL は、世界最高水準の AI 翻訳サービス です。
自然な文体表現と文脈理解に優れており、VoiceScriptPlayer では
字幕翻訳、セリフのリアルタイム翻訳、インターフェースの多言語化 などに利用されています。
💡 API サブスクリプションが初めての方へ
👉 DeepL サブスクリプションと API 設定ガイドを見る
2. アカウント作成 (Account Creation)¶
DeepL API を使用するには、DeepL アカウント が必要です。
- DeepL 公式サイト にアクセス
- 「無料トライアルを開始」 (Free API plan) または 有料プラン (Pro) を選択
- メールアドレスで登録し、確認メールで認証を完了
- ログイン後、[Account → API Key] メニューから API キーを確認
🔑 無料プラン（API Free）は月 50 万文字まで利用可能です。
Pro プランでは、より多くの文字数と高速な応答を利用できます。
3. API キーの発行 (API Key Setup)¶
登録後、DeepL アカウントページ にアクセスし、
以下のように API キーをコピーします：
例:
auth_key: 1234abcd-5678efgh-ijklmnop-qrstuvwx:fx
このキーを VoiceScriptPlayer の設定内にある DeepL API Key 入力欄 に貼り付けます。
⚠️ API キーは個人を識別できる情報です。公開リポジトリや共有ドキュメントには絶対に掲載しないでください。
4. 設定方法 (Configuration)¶
VoiceScriptPlayer では、DeepL 翻訳設定 から以下の項目を指定できます。
| 項目 | 説明 |
|---|---|
| API Key | DeepL アカウントから発行された認証キー |
| Source Language | 翻訳元の言語（例: JA, EN, KO） |
| Target Language | 翻訳先の言語（例: EN, KO, JA） |
5. 使用方法 (Usage)¶
- Whisper やその他の STT エンジンでテキストを抽出
- 翻訳先の言語を設定（例: 日本語 → 韓国語）
- 「翻訳」ボタンをクリック
- 翻訳結果が字幕またはテキストとして表示されます
💡 DeepL は 文単位翻訳 に最適化されています。
字幕文を一定の長さに分割して翻訳すると、より自然な結果が得られます。
💎 Pro 版 (DeepL API Pro) を使用すると、文脈理解や表現の精度が向上し、
特に 感情表現・比喩・婉曲語 の多い文章で自然で滑らかな結果を得ることができます。
🔍 翻訳品質の比較例¶
原文（日本語）:
ズルをしてレベルを上げるよりも、我慢して我慢してどうしても我慢できなくなってから出す方が気持ちいいですよ。
| 区分 | 翻訳結果 |
|---|---|
| Web 翻訳 (DeepL) | ズルをしてレベルを上げるよりも、我慢して我慢して、どうしても我慢できなくなってから出す方が気持ちいいですよ。 |
| DeepL API Free | ズルをしてレベルを上げるよりも、何度も我慢して、もう我慢できなくなってから出す方が気持ちいいですよ。 |
| DeepL API Pro | ズルをしてレベルを上げるよりも、限界まで我慢してから出す方がずっと気持ちいいですよ。 |
💬 解説：
Pro 版は単語単位ではなく 文脈全体を考慮 して翻訳を行うため、
感情やニュアンスを含む文章でもより自然で滑らかな結果を生成します。
6. 注意事項 (Notes & Limitations)¶
- 無料プランでは 月 50 万文字 の制限があります。
- API キーはアカウント固有であり、複数の PC で同時使用すると リクエスト制限 が発生する場合があります。
- DeepL は インターネット接続が必須 です。
- 翻訳品質は言語ペア（例: 英語↔日本語、英語↔韓国語）によって異なります。
- DeepL API Free と DeepL API Pro は異なるエンドポイントを使用します。
7. ライセンスと出典 (License & Credits)¶
- DeepL API：専有ライセンス (© DeepL SE)
- 公式サイト：https://www.deepl.com
- 公式 API ドキュメント：https://www.deepl.com/docs-api
- 商用利用可能（ただし DeepL の利用規約を遵守する必要があります）
8. VoiceScriptPlayer 内での翻訳機能の活用 (共通機能)¶
VoiceScriptPlayer では、すべてのテキスト入力欄 (TextBox) で
右クリックメニュー から直接翻訳機能を使用できます。
🧭 使用方法¶
- 翻訳したいテキストを選択して右クリック
- 「翻訳 → 韓国語に翻訳 (DeepL)」 または 「日本語に翻訳 (Web)」 を選択
- 翻訳エンジン（DeepL、Google、Papago など）を選択すると、即座に結果が表示されます。
⚡ ショートカットキー¶
- Ctrl + T
→ 現在選択しているテキストを 既定の翻訳エンジン で即時翻訳します。
（既定のエンジンは設定で変更可能）
🌐 対応翻訳エンジン¶
| 区分 | エンジン | 特徴 |
|---|---|---|
| ローカル API | DeepL Translate | 高精度、文脈理解に優れる |
| Web 翻訳 | Google Translate | 多言語に対応 |
| Web 翻訳 | Naver Papago | 韓国語・日本語翻訳に強い |
💡 ヒント：
この機能はすべての翻訳エンジン（DeepL、Google、Papago）に共通で、
プロジェクト内の セリフエディタ、字幕エディタ、テキスト入力欄 など、
ほぼすべてのテキスト入力エリアで使用できます。
9. トラブルシューティング (Troubleshooting / FAQ)¶
-
❓ 「Invalid authentication key」 エラーが発生します。
→ API キーが正しく入力されているか、空白が含まれていないか確認してください。 -
❓ 「Quota exceeded」 エラーが発生します。
→ 無料プランの上限（50 万文字）を超えています。Pro プランへアップグレードするか、翌月までお待ちください。 -
❓ 「翻訳されません」
→ ネットワーク接続を確認し、API Free/Pro のエンドポイントが正しいか確認してください。