# Immersive Translate

Immersive Translate는 사용자 지정 AI 번역 서비스를 추가할 수 있습니다. 주소, 키, 모델을 입력하면 NezhaGate 모델로 웹페이지와 PDF를 번역할 수 있습니다.

> https://nezhagate.com/ko/docs/integrations/immersive-translate

작성 기준 버전: Immersive Translate 1.33

## 번역 서비스 추가하기

1. 확장 프로그램의 **Settings** → **Translation Services**를 열고 맨 아래로 스크롤해 **Add Custom Translation Service**를 클릭하세요.

2. **Custom AI**를 선택하세요(다른 프로토콜을 쓰는 Custom API가 아닙니다).

3. 아래 표대로 입력한 뒤 저장하세요.

| 필드 | 값 |
| --- | --- |
| **Custom API interface address** | `https://nezhagate.com/v1/chat/completions` |
| **APIKEY** | NezhaGate API 키 |
| **Model** | **Set up more models**를 클릭해 **Custom Model List**에 모델 ID를 쉼표로 구분해 입력한 뒤 하나를 선택하세요. |
| **Max requests per second** | 3~5 정도가 적당합니다(기본값 5). 페이지를 번역하면 많은 요청이 동시에 발생하므로 값을 너무 높게 잡으면 요청 제한에 걸릴 수 있습니다. |

## 어떤 모델을 쓸까요

페이지 번역은 짧은 요청을 대량으로 보내는 작업이라 오래 생각하지 않고 빠르게 답하는 모델이 가장 알맞습니다. 사고형 모델은 문단마다 먼저 생각하기 때문에 더 느리고 출력 토큰도 더 많이 씁니다. 예를 들면:

`gemini-3.6-flash-low` · `claude-sonnet-4-6`

## Claude(선택 사항)

확장 프로그램에 내장된 **Claude** 서비스를 자신의 키로 쓸 수도 있습니다. 이때 API 주소는 `https://nezhagate.com/anthropic/v1/messages`로 설정하세요.

## 테스트

**Verify service**를 클릭하세요. **Successful**이 표시되면 아무 페이지나 번역해 보세요.

## 자주 나오는 오류

**429가 뜨거나 번역이 중간에 실패할 때**

**Max requests per second**를 예를 들어 3으로 낮추세요.

**401 / 404**

401은 키가 잘못된 것이고, 404는 주소가 잘못된 것입니다. `https://nezhagate.com/v1/chat/completions`여야 합니다.

**서비스 테스트가 계속 실패할 때**

유형이 Custom API가 아니라 **Custom AI**인지, 모델 ID가 사용자 지정 모델 목록에 들어 있고 선택되어 있는지 확인하세요.

**유저스크립트 버전이 요청을 보내지 못할 때**

스크립트 헤더에 `// @connect`로 NezhaGate 도메인을 선언해야 합니다.