순수 번역 제공업체
순수 번역 제공업체가 무엇인지, Read Frog가 어떤 것들을 지원하는지, 각각 무엇이 필요한지, 그리고 LLM 제공업체 대신 언제 이것을 고를지 설명합니다.
순수 번역 제공업체란
순수 번역 제공업체는 한 가지만 합니다. 텍스트를 보내면 번역을 돌려줍니다. 고를 모델도, 쓸 프롬프트도, 대화도 없습니다. Read Frog는 설정 → API 제공업체 → 제공업체 추가에서 이들을 순수 번역 제공업체 그룹으로 묶어 둡니다.
LLM 제공업체는 번역해 달라는 요청을 받아서 번역합니다. 그 한 단계가 더 있기 때문에 페이지 컨텍스트, 직접 쓴 프롬프트 문구, 용어집이 가능해집니다 — 그리고 같은 이유로 token이 더 들고 보통 더 오래 걸립니다.
이들이 할 수 없는 것
순수 번역 제공업체는 페이지 번역, 비디오 자막, 선택 툴바 번역, 입력 번역에 지정할 수 있습니다. 하지만 프롬프트에 의존하는 것은 아무것도 실어 보낼 수 없습니다.
- AI 스마트 컨텍스트는 보강할 프롬프트가 없으므로, 이 제공업체들에서는 이 설정이 아무 일도 하지 않습니다.
- 사용자 정의 번역 프롬프트는 선택한 제공업체가 LLM이 아니면 팝업에서 회색으로 비활성화됩니다.
- 맞춤형 AI 작업과 노트 제안은 LLM 제공업체가 필요하며, 이들 중 하나를 받아들이지 않습니다.
- 자막 AI 분할은 건너뜁니다. 자막은 도착하는 대로 한 줄씩 번역됩니다.
- 용어집 용어는 무시됩니다. 용어집은 시스템 프롬프트 안에 담겨 전달되므로 LLM 번역에만 닿습니다.
어떤 페이지에서 용어집이 갑자기 듣지 않으면, 그 기능이 어느 제공업체를 쓰고 있는지 확인하세요. 기능마다 제공업체를 따로 고르므로, 페이지 번역은 DeepL로 바뀌었는데 선택 툴바는 아직 LLM에 남아 있을 수 있습니다.
이 그룹에 있는 제공업체
DeepL
DeepL 공식 API입니다. API Key 하나만 필요하고 그 밖에는 아무것도 필요 없습니다 — Base URL 필드가 없는데, Read Frog가 Key의 형태를 보고 Free 또는 Pro 엔드포인트를 고르기 때문입니다. 자세한 내용과 언어 코드 처리 방식은 DeepL을 참고하세요.
DeepLX
비공식 DeepL 호환 API입니다. Base URL이 필요하고, API Key는 쓰는 인스턴스가 요구할 때만 필요합니다. 그래서 무료 공개 인스턴스라면 Key 필드를 비워 둔 채로도 동작합니다. 서비스가 token을 경로가 아닌 다른 위치에서 기대하는 경우, Base URL에 {{apiKey}} 자리표시자를 넣을 수 있습니다. DeepLX를 참고하세요.
Google Translate와 Microsoft Translator
이 둘은 같은 계열이지만 설정이 전혀 필요 없습니다. 이미 추가되고 활성화된 상태로 제공되며, 채울 인증 정보가 없고, 삭제할 수도 없습니다. 그래서 제공업체 추가 대화상자에서는 찾을 수 없습니다.
Microsoft Translator는 번역만 페이지 모드와 함께 쓸 수 없습니다. 이 엔드포인트는 마크업을 보존하지 않으므로, Read Frog는 페이지가 깨지도록 두는 대신 그 조합을 아예 막습니다.
추가하고 활성화하기
제공업체 추가를 클릭하고 순수 번역 제공업체 그룹에서 제공업체를 하나 고릅니다.
그 제공업체가 보여 주는 필드를 채웁니다 — DeepL은 API Key, DeepLX는 Base URL(그리고 선택적으로 Key)입니다.
추가만 하고 활성화하지 않은 제공업체는 기능 선택기에 나타나지 않습니다. 제공업체 편집기에서 바로 기능에 지정하면 활성화까지 대신 해 줍니다.
연결 테스트하기
연결 테스트는 단순한 핑이 아닙니다 — 실제 설정을 그대로 써서 Hi라는 단어를 번역하므로, 녹색 체크는 바로 이 구성이 번역을 만들어 냈다는 뜻입니다.
- 녹색 체크는 성공입니다. 모래시계는 성공했지만 3초보다 오래 걸렸다는 뜻입니다.
- 빨간 X는 요청이 실패했다는 뜻입니다. 이유는 버튼에 표시되지 않으므로, 실제 페이지에서 한 번 번역해 오류 문구를 확인하세요.
- API Key 필드가 비어 있으면 버튼을 누를 수 없습니다. Key 없이 실행해도 되는 DeepLX만 예외입니다.
- 결과는 몇 초 뒤에 사라지고, 제공업체나 Key, URL을 수정하면 곧바로 초기화됩니다 — 그래서 오래된 체크 표시가 그 사이 바뀐 구성을 보증하는 일은 없습니다.
언제 이것을 고를지
다음과 같을 때 순수 번역 제공업체를 고르세요.
- 긴 페이지나 자막 트랙 전체를 번역하면서 요청당 지연을 가장 낮게 두고 싶습니다.
- 비용을 예측 가능하게 두고 싶습니다. DeepL은 token이 아니라 문자 수로 청구하고, 무료 DeepL Key나 공개 DeepLX 인스턴스는 비용이 들지 않습니다.
- LLM 할당량이 넉넉하지 않아서, 대량 페이지 번역보다 맞춤형 AI 작업에 쓰고 싶습니다.
다음과 같을 때는 LLM 제공업체에 머무르세요.
- 용어집, 사용자 정의 프롬프트, AI 스마트 컨텍스트에 의존합니다.
- 글자 그대로의 정확성보다 판단이 필요한 텍스트입니다 — 관용구, 농담, 분야 전문 용어.
- 두 벌을 유지하지 않고, 한 제공업체가 번역과 AI 기능을 모두 맡게 하고 싶습니다.
괜찮은 중간 지점은 페이지 번역은 순수 번역 제공업체로 돌리고 선택 툴바는 LLM에 남겨 두는 것입니다. 그러면 빠른 경로는 저렴하고, 멈춰 서서 들여다보는 단어에는 공들인 경로가 그대로 남습니다.
문제 해결
"DeepL API key is not configured"
API Key 필드가 비어 있습니다. DeepL에는 Key 없이 쓰는 모드가 없습니다.
"DeepL translation request failed" 또는 "DeepLX translation request failed"
제공업체가 오류 상태로 응답했습니다. Read Frog는 이 메시지 뒤에 상태 코드와 제공업체 자신의 오류 본문을 붙이며, 보통 그것이 가장 먼저 읽을 만한 정보입니다. 흔한 원인은 Key가 잘못되었거나 만료된 경우, Key가 요금제와 맞지 않는 경우, 문자 할당량을 다 쓴 경우입니다.
"API key is required when using {{apiKey}} placeholder in DeepLX baseURL"
Base URL에 자리표시자가 들어 있는데 API Key 필드가 비어 있습니다. Key를 채우거나 URL에서 자리표시자를 지우세요.
"Unexpected response format from DeepLX translation API"
요청은 성공했지만 본문이 DeepLX 인스턴스가 돌려주는 형태가 아닙니다. Read Frog는 번역문이 data 문자열 필드에 담긴 JSON을 기대합니다. 용도가 바뀌었거나 로그인 페이지 뒤로 옮겨진 공개 인스턴스가 여기서 자주 실패합니다.
"Network error during DeepL/DeepLX translation"
요청이 서버에 아예 닿지 못했습니다. 인스턴스가 꺼져 있거나, 호스트 이름이 해석되지 않거나, CORS 헤더가 확장 프로그램을 거부합니다. 직접 호스팅한 인스턴스는 터미널에서만이 아니라 브라우저에서도 접근할 수 있어야 합니다.
번역은 괜찮은데 용어가 틀립니다
이 제공업체들에서는 예상된 동작입니다 — 위의 이들이 할 수 없는 것을 참고하세요. 용어집이 속도보다 중요하다면 그 기능을 LLM 제공업체로 옮기세요.
관련 페이지
제공업체와 API Key 설정 · DeepL · DeepLX · 내장 제공업체 구성 · OpenAI 호환 사용자 제공업체
