AI 번역

AI 번역 기능을 사용하면 대규모 언어 모델(LLM)을 통해 열려 있는 TS 파일의 번역문을 자동으로 생성할 수 있습니다. 로컬 LLM 서버(예: Ollama, LM Studio, llama.cpp)나 OpenAI 호환 REST 프로토콜을 지원하는 클라우드 기반 API(예: OpenAI, Groq, Anthropic) 중 하나를 사용할 수 있습니다.

Qt Linguist 다음과 같은 두 가지 API 모드를 지원합니다:

• Ollama - Ollama의 기본 REST API입니다. Ollama를 로컬에서 실행할 때 이 모드를 사용하십시오.
• OpenAI 호환 - 표준 OpenAI REST API 형식입니다. 다음의 경우에 사용하십시오:
  • 로컬 서버: LM Studio, llama.cpp 또는 Ollama(Ollama는 OpenAI 호환 모드도 지원합니다)
  • 클라우드 제공업체: OpenAI, Groq, DeepSeek 등

로컬 LLM 서버 설정

로컬 서버에서 AI 번역 기능을 사용하려면 다음 중 하나를 설치하고 모델을 하나 이상 다운로드하십시오:

• Ollama - 사용하기 쉽고, 모델을 자동으로 관리해 줍니다
• LM Studio - 모델 브라우저가 포함된 GUI 애플리케이션
• llama.cpp - 가볍고, GGUF 모델을 직접 실행합니다

Ollama의 경우, 명령줄을 사용하여 모델을 가져오십시오:

ollama pull qwen3:14b
ollama serve

LM Studio의 경우, 애플리케이션 인터페이스를 통해 모델을 다운로드하고 로컬 서버를 시작하십시오:

lms server start

llama.cpp의 경우, 내장된 모델 사전 설정 중 하나를 사용할 수 있습니다:

llama-server --fim-qwen-7b-default

또는 GGUF 모델 파일을 다운로드하여 서버를 수동으로 시작할 수 있습니다:

llama-server -m model.gguf --port 8080

클라우드 API 사용

클라우드 기반 번역 서비스를 사용하려면 API 유형으로 ‘OpenAI 호환’을 선택하고, 제공업체의 API 엔드포인트 URL을 입력한 후 API 키를 입력하십시오.

/v1 경로 접미사를 제외한 기본 URL만 입력하십시오. 예를 들어, OpenRouter의 경우 https://openrouter.ai/api 을 사용합니다. 정확한 엔드포인트 URL은 제공업체의 설명서를 참조하십시오.

AI 번역 대화 상자 사용

Linguist에서 ‘ Tools > AI Translation ’을 선택하여 AI 번역 대화 상자를 엽니다:

대화 상자의 ‘ Configuration ’ 섹션에서는 다음 기능을 제공합니다:

• API Type: Ollama의 네이티브 API를 사용하는 로컬 Ollama 서버의 경우 ‘Ollama’를, LM Studio, llama.cpp, 클라우드 API 또는 OpenAI 호환 모드의 Ollama를 사용하는 경우 ‘OpenAI Compatible’을 선택하십시오.
• Server URL: 서버가 리스닝하는 기본 URL입니다. /v1 경로 접미사는 포함하지 마십시오. 기본값: Ollama의 경우 http://localhost:11434, OpenAI 호환 모드의 경우 http://localhost:8080 입니다.
• API Key: 클라우드 API용 인증 키(로컬 서버의 경우 선택 사항).
• Model: 사용 가능한 모델의 드롭다운 목록.
• Context: 번역 정확도를 높이기 위한 선택적 애플리케이션 컨텍스트(예: "의료 소프트웨어", "비디오 게임", "금융 애플리케이션").

대화 상자의 ‘ Selection ’ 섹션에서는 다음을 제공합니다:

• File: 번역할 TS 파일.
• Filter: 번역을 특정 그룹(컨텍스트 또는 레이블)으로 제한합니다.
• Translate: AI 번역을 시작합니다.

대화 상자의 ‘ Progress ’ 섹션에서는 다음 기능을 제공합니다:

• 번역 진행을 중지하는 중지 버튼
• Apply Translations: 번역된 항목을 TS 파일에 적용합니다.

번역이 진행되는 동안 ' Translation Log'에 진행 상황 메시지가 표시됩니다. 번역이 완료되면 로그에서 번역된 텍스트를 검토하십시오. ' Apply Translations '를 클릭하여 AI가 생성한 번역 내용을 TS 파일에 삽입하십시오.

보안 고려 사항

AI 번역 기능은 네트워크를 통해 사용자가 구성한 서버로 데이터를 전송합니다. 이 기능을 사용하기 전에 다음 사항을 고려하십시오:

• 기밀 문자열은 원격 서버에 저장하지 마십시오. Qt Linguist 은 번역할 원본 문자열과 사용자가 제공한 Context 을 구성된 서버로 전송합니다. 신뢰할 수 있는 서버만 사용하며, 가급적 로컬 LLM 서버를 사용하십시오.
• AI가 생성한 번역은 적용하기 전에 검토하십시오. Qt Linguist 는 서버의 번역 결과를 있는 그대로 삽입합니다. 예상치 못한 마크업이나 서식 지정자가 포함될 수 있으므로, Apply Translations 를 선택하기 전에 Translation Log 에서 이를 신뢰할 수 없는 콘텐츠로 간주하고 검토하십시오.
• 원격 서버의 경우 HTTPS를 우선적으로 사용하십시오. Qt Linguist 는 요청에 API 키를 베어러 토큰(bearer token)으로 전송합니다. Server URL 에서 https 대신 http 를 사용하면, 네트워크 경로에 있는 누구나 키와 원본 텍스트를 평문으로 읽을 수 있습니다. 로컬 컴퓨터에서 실행되지 않는 모든 서버의 경우 https 를 사용하십시오.

권장 모델

다음 모델들은 품질, 속도, 리소스 사용량의 균형을 고려하여 번역 작업에 권장됩니다. 이 모델들은 다음에서 확인할 수 있습니다:

• Ollama - 모델 이름으로 검색 (예: ollama pull qwen3:14b)
• LM Studio - 모델 브라우저에서 검색
• Hugging Face - llama.cpp용 GGUF 파일 다운로드

리소스가 제한된 시스템의 경우, Qwen3 8B (5 GB)나 Qwen2.5 7B (5 GB)와 같은 더 작은 규모의 변형을 사용하면 메모리 사용량을 줄이면서도 합리적인 번역 품질을 얻을 수 있습니다.