---
url: "/ja/copydoc/localization/gemini.md"
description: "CopyDocでGeminiを使い、APIによる直接翻訳か手動のCSVプロンプトで、選択したFigmaフレームをFigma内でローカライズできます。"
---

# GeminiでFigmaフレームを翻訳する

> CopyDocでGeminiを使い、APIによる直接翻訳か手動のCSVプロンプトで、選択したFigmaフレームをFigma内でローカライズできます。

CopyDocでは、次の2つの方法でGeminiを使えます。

- **Gemini API**：プラグイン内で翻訳とインポートを自動で行います。
- **Gemini Prompt**：Geminiアプリを使って、手動でコピー＆ペーストするワークフローです。

## Gemini APIを使う {#use-gemini-api}

1. CopyDocで**Localize Frames**ボタンをクリックします。
2. **Gemini API**を選びます。
3. Google AI Studioの[APIキー](https://aistudio.google.com/app/apikey)を貼り付けます。
4. CopyDocで使うGeminiのモデルを選びます。
5. 翻訳したいFigmaフレームと対象のロケールを選びます。
6. 翻訳時にインラインの太字、斜体、リンク付きテキストを保持したい場合は、**Use Markdown**をオンにします。
7. **Translate & Import**をクリックします。

CopyDocは、選択したフレームのテキストをGeminiに送信して翻訳し、翻訳結果を、ローカライズ済みの複製フレームとしてFigmaに自動でインポートします。

> **Tip:** GeminiのAPIキーは、Figmaユーザーごとにお使いのデバイスに保存され、Figmaファイル自体には保存されません。

## Gemini Promptを使う {#use-gemini-prompt}

1. ローカライズのオプションで**Gemini Prompt**を選びます。
2. 翻訳したいFigmaフレームとロケールを選びます。
3. **Generate Prompt**をクリックします。
4. **Copy Prompt to Clipboard**をクリックします。
5. Geminiでプロンプトを実行し、応答に**CSVのみ**がそのまま含まれていることを確認します。
6. CSVの応答をCopyDocに貼り付けます。
7. **Translate Figma Frames**をクリックして、翻訳したコンテンツをFigmaにインポートします。

手動のプロンプトのワークフローでは、GeminiのモデルはGemini内で自分で選びます。CopyDocは、翻訳したフレームをFigmaにインポートする前にCSVの構造を検証します。

生成されるプロンプトでは、対応するインラインのMarkdown書式を保持し、Markdownの記号、URL、プレースホルダーを変更しないようにGeminiに指示しているため、翻訳したコンテンツを正しくFigmaにインポートできます。

> **Tip:** CSVの応答にある`id`、`frame_id`、`layer_name`、`figma_text`列は、削除したり名前を変えたりしないでください。CopyDocはこれらの列を使って、翻訳された行を正しいFigmaレイヤーに対応付けます。