> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crazyrouter.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 이머시브 트랜슬레이트(沉浸式翻译) 설정 가이드
> 이머시브 트랜슬레이트 브라우저 확장 프로그램에서 OpenAI 서비스를 통해 Crazyrouter를 연동하고, 사용자 지정 API 주소, 모델, 빈도 제어, 검증 및 문제 해결 방법을 보완합니다
> 업데이트: 2026-06-06
이머시브 트랜슬레이트는 일상적인 웹페이지 번역, 이중 언어 읽기, 선택 번역, 문서 번역에 매우 적합한 브라우저 확장 프로그램입니다. Crazyrouter와 연동할 때 가장 안정적인 방법은 공식적으로 지원하는 `OpenAI` 서비스 설정을 사용하고, `추가 설정`에서 사용자 지정 API 주소를 입력하는 것입니다.
## 개요
이머시브 트랜슬레이트의 OpenAI 서비스 설정을 통해 요청을 Crazyrouter로 보낼 수 있습니다:
* 권장 프로토콜: `OpenAI-compatible API`
* 서비스 유형: `OpenAI`
* API 키: 사용자의 `sk-...`
* 사용자 지정 API 주소: `https://api.crazyrouter.com/v1/chat/completions`
* 권장 첫 검증 모델: `gpt-5.5`
이머시브 트랜슬레이트와 ChatBox의 가장 큰 차이점은, 여기서는 일반적으로 완전한 인터페이스 경로를 입력해야 하며, 루트 도메인만 입력해서는 안 된다는 것입니다.
## 왜 여기서는 완전한 경로를 입력해야 하는가
이머시브 트랜슬레이트 공식 OpenAI 서비스 문서에 따르면, `추가 설정`에서 사용자 지정 OpenAI API 주소를 지원합니다. 따라서 Crazyrouter를 여기서 설정할 때는 일반적으로 완전한 주소를 사용하는 것이 더 안정적입니다:
```text theme={null}
https://api.crazyrouter.com/v1/chat/completions
```
여기를 루트 도메인 `https://api.crazyrouter.com`으로 작성하지 마십시오. 또한 `/v1`까지만 작성하지도 마십시오. 이머시브 트랜슬레이트와 같은 연동 방식에서는 첫 라운드 검증 시 완전한 `/v1/chat/completions` 경로를 우선 사용하십시오.
## 이런 분들께 적합합니다
* 웹페이지에서 고품질 AI 번역을 하고 싶은 분
* Crazyrouter 자체 토큰으로 번역 비용을 관리하고 싶은 분
* 서로 다른 브라우저나 기기별로 할당량을 분리하여 관리하고 싶은 분
* OpenAI 호환 방식을 우선하여 브라우저 번역 확장 프로그램을 연동하고 싶은 분
## 시스템 요구사항 및 사전 준비 조건
| 항목 | 설명 |
| ------------------- | ----------------------------------------------------- |
| Crazyrouter 계정 | 먼저 [crazyrouter.com](https://crazyrouter.com)에서 가입합니다 |
| Crazyrouter 토큰 | 이머시브 트랜슬레이트용으로 별도의 토큰을 생성하는 것을 권장합니다 |
| 브라우저 | Chrome, Edge, Firefox 등 해당 확장 프로그램을 지원하는 브라우저 |
| 이머시브 트랜슬레이트 확장 프로그램 | 현재 안정 버전 권장 |
| 사용 가능한 모델 | 최소 1개의 번역 모델을 허용해야 합니다 |
권장 초기 화이트리스트:
* `gpt-5.5`
* `claude-opus-4-8`
## 설치 및 설정 경로
### Chrome / Edge 경로
1. 확장 프로그램 스토어에서 이머시브 트랜슬레이트를 설치합니다
2. 확장 프로그램 설정을 엽니다
3. `번역 서비스`로 이동합니다
4. `OpenAI`를 선택합니다
5. `추가 설정`을 엽니다
6. Crazyrouter 키와 완전한 사용자 지정 주소를 입력합니다
### Firefox 경로
1. Firefox 애드온에서 이머시브 트랜슬레이트를 설치합니다
2. 설정 페이지를 엽니다
3. `번역 서비스`로 이동합니다
4. `OpenAI`를 선택합니다
5. `추가 설정`으로 이동합니다
6. Crazyrouter 파라미터를 입력합니다
## 처음부터 전체 설정하기
공식 확장 프로그램 스토어에서 "이머시브 트랜슬레이트"를 설치합니다.
처음에는 다음만 허용하는 것을 권장합니다:
* `gpt-5.5`
* `claude-opus-4-8`
처음부터 많은 모델을 번역 시나리오에 추가하지 마십시오.
확장 프로그램 아이콘을 클릭한 후 다음으로 이동합니다:
* `설정`
* `번역 서비스`
* `OpenAI` 선택
다음을 입력합니다:
* `API Key`: 사용자의 `sk-...`
* `사용자 지정 API 인터페이스 주소`: `https://api.crazyrouter.com/v1/chat/completions`
* `모델`: 먼저 `gpt-5.5`를 입력합니다
인터페이스에서 일부 파라미터가 기본적으로 접혀 있다면, `추가 설정`을 펼쳐서 전체 필드를 확인해야 합니다.
이머시브 트랜슬레이트 공식 문서는 OpenAI 경로에 대해 빈도 제한 문제를 특별히 경고하고 있습니다. Crazyrouter를 처음 연동할 때는 요청 빈도를 다소 낮게 설정하는 것을 권장합니다. 특히 긴 문서나 전자책을 번역할 때 그렇습니다.
첫 라운드는 다소 보수적으로 설정하는 것을 권장합니다. 예를 들어:
* 초당 요청 수를 너무 높게 설정하지 않습니다
* 먼저 작은 페이지나 선택한 텍스트로 검증합니다
* 정상 작동을 확인한 후 천천히 높입니다
권장 순서:
1. 먼저 짧은 선택 텍스트를 번역합니다
2. 그다음 짧은 웹페이지를 번역합니다
3. 마지막으로 전체 페이지나 더 긴 문서를 테스트합니다
이렇게 하면 "API 설정 오류"와 "요청량이 너무 많아 불안정함"을 가장 쉽게 구분할 수 있습니다.
## 권장 모델 설정
| 사용 시나리오 | 권장 모델 | 이유 |
| ------------ | ----------------- | ----------------------------------------------------------------- |
| 첫 라운드 최소 검증 | `gpt-5.5` | 2026년 3월 23일 프로덕션 환경에서 실측 성공했으며, OpenAI 호환 번역 링크를 먼저 검증하는 데 적합합니다 |
| 더 높은 품질의 번역 | `claude-opus-4-8` | 장문 설명, 윤문 및 품질이 중요한 시나리오에 더 적합합니다 |
| Gemini 대체 옵션 | `gemini-3.1-pro` | 두 번째 호환성 검증 경로로 적합하지만, 먼저 메인 링크를 검증한 후 시도하는 것을 권장합니다 |
## 토큰 설정 모범 사례
| 설정 | 권장 사항 | 설명 |
| --------- | ------ | ----------------------------------------------- |
| 전용 토큰 | 필수 | 브라우저 번역 확장 프로그램은 IDE / CLI 도구와 토큰을 공유하지 않아야 합니다 |
| 모델 화이트리스트 | 강력히 권장 | 처음에는 1\~2개의 번역 모델만 개방합니다 |
| 할당량 상한 | 강력히 권장 | 전체 페이지 번역, 전자책 번역은 일반 대화보다 소비 속도가 빠릅니다 |
| 기기 분리 | 권장 | 서로 다른 브라우저나 기기별로 토큰을 분리할 수 있습니다 |
| 유출 처리 | 즉시 교체 | 녹화, 스크린샷, 브라우저 동기화 유출 후에는 즉시 키를 교체해야 합니다 |
## 검증 체크리스트
* [ ] 확장 프로그램을 올바르게 설치했습니다
* [ ] `OpenAI` 번역 서비스를 선택했습니다
* [ ] `API Key`를 올바르게 입력했습니다
* [ ] `사용자 지정 API 인터페이스 주소`를 `https://api.crazyrouter.com/v1/chat/completions`로 설정했습니다
* [ ] 첫 번째 모델을 `gpt-5.5` 또는 다른 허용된 모델로 설정했습니다
* [ ] 짧은 선택 텍스트 번역이 성공했습니다
* [ ] 짧은 웹페이지 번역이 성공했습니다
* [ ] Crazyrouter 백엔드 로그에서 해당 요청을 확인할 수 있습니다
## 자주 발생하는 오류와 해결 방법
| 현상 | 일반적인 원인 | 해결 방법 |
| ----------------------- | ----------------------------------------------- | ------------------------------------------------------------ |
| 404 | API 주소에 `/chat/completions`가 빠졌거나, 루트 도메인으로 작성됨 | 완전한 주소 `https://api.crazyrouter.com/v1/chat/completions`로 변경 |
| 401 unauthorized | API 키 오류, 만료, 또는 불완전한 복사 | 토큰을 다시 생성하고 다시 입력 |
| 403 / model not allowed | 토큰이 현재 모델을 허용하지 않음 | Crazyrouter 토큰 설정에서 모델을 허용합니다 |
| 429 / 불안정함 | 요청 빈도가 너무 높음 | 요청 빈도를 낮추고, 작은 텍스트부터 시작합니다 |
| 긴 문서 번역 시 실패율이 더 높음 | 동시성 또는 빈도가 너무 높음 | 먼저 번역 범위를 줄인 후 점진적으로 높입니다 |
| 비용이 너무 빠르게 증가함 | 전체 페이지, 전체 사이트, 또는 전자책을 바로 번역함 | 먼저 `gpt-5.5`로 소규모 검증을 하고 번역 범위를 제어합니다 |
## 비용 절감 방법
* 기본적으로 먼저 `gpt-5.5`를 사용합니다
* 처음부터 전체 페이지 번역을 하지 말고, 선택 영역 번역을 우선합니다
* 긴 문서는 먼저 샘플로 품질을 검증한 후 전체 번역 여부를 결정합니다
* 여러 브라우저에 확장 프로그램을 설치했다면, 토큰을 분리하여 비용을 통계하는 것을 권장합니다
## FAQ
### 이머시브 트랜슬레이트에는 어떤 API 주소를 입력해야 하나요?
완전한 경로를 입력합니다: `https://api.crazyrouter.com/v1/chat/completions`.
### 왜 여기서는 ChatBox와 다르게 루트 도메인만 입력하는 것을 권장하지 않나요?
이머시브 트랜슬레이트의 공식 OpenAI 사용자 지정 주소 입력 항목은 완전한 인터페이스 경로를 직접 입력하는 것에 더 적합하며, 첫 라운드 검증이 더 안정적이기 때문입니다.
### 첫 번째 권장 모델은 무엇인가요?
먼저 `gpt-5.5`를 사용합니다.
### 왜 처음부터 전체 페이지나 전자책을 바로 번역하는 것을 권장하지 않나요?
설정 문제, 빈도 제한, 비용 문제를 동시에 증폭시킬 수 있기 때문입니다. 먼저 짧은 텍스트를 번역하면 문제 해결이 가장 빠릅니다.
목표가 "Crazyrouter로 웹페이지 AI 번역 비용을 관리하는 것"이라면, 이머시브 트랜슬레이트는 세부 설명을 보완할 가치가 매우 높은 브라우저 확장 프로그램 유형입니다.