---
url: "/pt/copydoc/localization/gemini.md"
description: "Use o Gemini no CopyDoc, com tradução direta pela API ou prompts manuais em CSV, para localizar os frames selecionados no Figma."
---

# Traduzir seus frames do Figma com o Gemini

> Use o Gemini no CopyDoc, com tradução direta pela API ou prompts manuais em CSV, para localizar os frames selecionados no Figma.

O CopyDoc oferece duas formas de usar o Gemini:

- **Gemini API**, para traduzir e importar automaticamente dentro do plugin.
- **Gemini Prompt**, para um fluxo de trabalho manual de copiar e colar usando o app do Gemini.

## Usar a API do Gemini {#use-gemini-api}

1. Clique no botão **Localize Frames** no CopyDoc.
2. Escolha **Gemini API**.
3. Cole sua [chave de API](https://aistudio.google.com/app/apikey) do Google AI Studio.
4. Escolha o modelo do Gemini que o CopyDoc deve usar.
5. Selecione os frames do Figma e os idiomas de destino que você quer traduzir.
6. Ative **Use Markdown** se precisar preservar negrito, itálico e links dentro do texto durante a tradução.
7. Clique em **Translate & Import**.

O CopyDoc envia o texto dos frames selecionados ao Gemini para tradução e depois importa automaticamente os resultados traduzidos de volta para o Figma como cópias localizadas dos frames.

> **Tip:** Sua chave de API do Gemini fica armazenada no seu dispositivo, por usuário do Figma, e não é salva no próprio arquivo do Figma.

## Usar o prompt do Gemini {#use-gemini-prompt}

1. Escolha **Gemini Prompt** nas opções de localização.
2. Selecione os frames do Figma e os idiomas que você quer traduzir.
3. Clique em **Generate Prompt**.
4. Clique em **Copy Prompt to Clipboard**.
5. Execute o prompt no Gemini e confira se a resposta contém **somente o CSV puro**.
6. Cole a resposta em CSV de volta no CopyDoc.
7. Clique em **Translate Figma Frames** para importar o conteúdo traduzido para o Figma.

No fluxo com prompt manual, você mesmo escolhe o modelo do Gemini dentro do Gemini. O CopyDoc valida a estrutura do CSV antes de importar os frames traduzidos para o Figma.

O prompt gerado também pede ao Gemini que preserve a formatação Markdown compatível dentro do texto e mantenha inalterados os marcadores Markdown, as URLs e os placeholders, para que o conteúdo traduzido possa ser importado corretamente de volta para o Figma.

> **Tip:** Não remova nem renomeie as colunas `id`, `frame_id`, `layer_name` ou `figma_text` na resposta em CSV. O CopyDoc usa essas colunas para relacionar as linhas traduzidas às camadas corretas do Figma.