---
url: "/ko/copydoc/localization/chatgpt.md"
description: "CopyDoc에서 ChatGPT API로 바로 번역하거나 CSV 프롬프트를 직접 실행해 선택한 Figma 프레임을 Figma 안에서 현지화하세요."
---

# ChatGPT로 Figma 프레임 번역하기

> CopyDoc에서 ChatGPT API로 바로 번역하거나 CSV 프롬프트를 직접 실행해 선택한 Figma 프레임을 Figma 안에서 현지화하세요.

CopyDoc은 두 가지 방식으로 ChatGPT를 지원해요.

- **ChatGPT API**: 플러그인 안에서 번역과 가져오기를 자동으로 처리해요.
- **ChatGPT Prompt**: ChatGPT 앱에서 직접 복사해 붙여 넣는 수동 워크플로예요.

## ChatGPT API 사용하기 {#use-chatgpt-api}

CopyDoc이 번역부터 가져오기까지 전체 과정을 처리하길 원한다면 API 워크플로가 가장 빠른 방법이에요.

1. CopyDoc에서 **Localize Frames** 버튼을 클릭하세요.
2. **ChatGPT API**를 선택하세요.
3. OpenAI [API 키](https://platform.openai.com/api-keys)를 붙여 넣으세요.
4. CopyDoc에서 사용할 모델을 선택하세요.
5. 번역할 Figma 프레임과 대상 로캘을 선택하세요.
6. 번역하는 동안 인라인 굵게, 기울임꼴, 링크 텍스트를 유지해야 한다면 **Use Markdown**을 켜세요.
7. **Translate & Import**를 클릭하세요.

CopyDoc이 선택한 프레임의 텍스트를 로캘마다 ChatGPT로 보낸 다음, 번역 결과를 복제된 현지화 프레임으로 Figma에 자동으로 가져와요.

> **Tip:** ChatGPT API 키는 Figma 사용자별로 내 기기에 저장되며, Figma 파일 자체에는 저장되지 않아요.

## ChatGPT Prompt 사용하기 {#use-chatgpt-prompt}

API 키를 연결하는 대신 ChatGPT에서 번역 요청을 직접 실행하고 싶다면 수동 프롬프트 워크플로가 유용해요.

1. 현지화 옵션에서 **ChatGPT Prompt**를 선택하세요.
2. 번역할 Figma 프레임과 로캘을 선택하세요.
3. **Generate Prompt**를 클릭하세요.
4. **Copy Prompt to Clipboard**를 클릭하세요.
5. ChatGPT에서 프롬프트를 실행하고, 응답이 다른 내용 없이 **CSV 원문만** 반환하는지 확인하세요.
6. CSV 응답을 CopyDoc에 다시 붙여 넣으세요.
7. **Translate Figma Frames**를 클릭해 번역된 콘텐츠를 Figma로 가져오세요.

수동 프롬프트 워크플로에서는 ChatGPT 앱에서 ChatGPT 모델을 직접 선택해요. CopyDoc은 붙여 넣은 CSV를 가져오기 전에 검증해요.

생성된 프롬프트는 ChatGPT에 지원되는 인라인 Markdown 서식을 유지하고 Markdown 기호, URL, 플레이스홀더를 바꾸지 말라고 지시해요. 그래야 번역된 콘텐츠를 Figma로 제대로 다시 가져올 수 있어요.

> **Tip:** CSV 응답에서 `id`, `frame_id`, `layer_name`, `figma_text` 열을 삭제하거나 이름을 바꾸지 마세요. CopyDoc은 이 열을 사용해 번역된 행을 올바른 Figma 레이어와 다시 연결해요.