백엔드

yaku는 네 가지 번역 백엔드를 지원합니다. 각각 텍스트를 다른 LLM 제공자에게 보냅니다.

사용 가능한 백엔드

백엔드	기본 모델	비고
hosted	서버 측	설정 불필요 기본값. 정교한 언어별 프롬프트.
gemini	gemini-2.5-flash	Google AI Studio에서 무료 API 키 발급.
openai	gpt-4o-mini	OpenAI 호환 API(Groq, Together, DeepSeek, Ollama)에서도 작동.
anthropic	claude-haiku-4-5-20251001	Anthropic Messages API를 통해 Claude 모델 사용.

모든 백엔드는 일관되고 변동이 적은 번역을 위해 온도 0.3을 사용합니다. --verbose를 사용하면 yaku가 API가 실제 사용한 모델 버전을 보고합니다(지정한 별칭과 다를 수 있습니다).

yaku의 백엔드 선택 방식

백엔드는 다음 순서로 결정됩니다:

1. --backend 옵션 — 지정하면 항상 우선.
2. 설정의 backend 필드 — 옵션이 없으면 사용.
3. 기본값 — hosted. API 키가 있어도 기본값은 변경되지 않습니다. 로컬 백엔드를 명시적으로 선택해야 합니다.

# 설정 없음 → hosted 사용 (기본값)
yaku --to ko "Hello"

# API 키 설정됨, 하지만 백엔드 미설정 → 여전히 hosted 사용
yaku config set api-key AIza...
yaku --to ko "Hello"

# 로컬 백엔드를 명시적으로 선택하여 API 키 사용
yaku config set backend gemini
yaku --to ko "Hello"

# --backend 옵션으로 명령별 재정의
yaku --backend openai --to ko "Hello"

호스팅 백엔드

기본 백엔드입니다. 로컬 백엔드보다 높은 번역 품질을 위해 정교한 언어별 프롬프트를 사용합니다. 비교, 플랜 등급, 할당량 제한은 호스팅 서비스 & 플랜을 참조하세요.

# 호스팅 백엔드 사용 (항상 기본값)
yaku --to ko "こんにちは"

호스팅 엔드포인트 커스터마이즈:

yaku config set hosted-url https://api.staging.yakulang.com

Gemini 백엔드

Google의 Gemini API를 사용합니다. Google AI Studio에서 무료 API 키를 받으세요. yaku는 지연 시간과 토큰 비용을 줄이기 위해 Gemini의 사고 모드를 비활성화합니다. 번역은 추론 작업이 아닌 명령 수행 작업입니다.

# 설정
yaku config set api-key YOUR_GEMINI_API_KEY

# 또는 환경 변수 사용
export GOOGLE_API_KEY=YOUR_GEMINI_API_KEY

모델 재정의:

yaku --model gemini-2.5-pro --to ko "Hello"

OpenAI 백엔드

OpenAI의 API와 모든 OpenAI 호환 제공자에서 작동합니다.

# OpenAI
yaku config set backend openai
yaku config set api-key YOUR_OPENAI_API_KEY

# 또는 환경 변수 사용
export OPENAI_API_KEY=YOUR_OPENAI_API_KEY
yaku --backend openai --to ko "Hello"

OpenAI 호환 제공자

--api-base를 사용하여 호환 엔드포인트를 지정합니다:

# Groq
yaku --backend openai \
  --api-base https://api.groq.com/openai/v1 \
  --model llama-3.3-70b-versatile \
  --to ko "Hello"

# Together.ai
yaku --backend openai \
  --api-base https://api.together.xyz/v1 \
  --model meta-llama/Llama-3-70b-chat-hf \
  --to ko "Hello"

# 로컬 Ollama
yaku --backend openai \
  --api-base http://localhost:11434/v1 \
  --model llama3 \
  --to ko "Hello"

# DeepSeek
yaku --backend openai \
  --api-base https://api.deepseek.com/v1 \
  --model deepseek-chat \
  --to ko "Hello"

옵션을 반복하지 않도록 기본값으로 저장:

yaku config set backend openai
yaku config set api-base https://api.groq.com/openai/v1
yaku config set model llama-3.3-70b-versatile
yaku config set api-key YOUR_GROQ_API_KEY

Anthropic 백엔드

Anthropic Messages API를 통해 Claude 모델을 사용합니다.

yaku config set backend anthropic
yaku config set api-key YOUR_ANTHROPIC_API_KEY

# 또는 환경 변수 사용
export ANTHROPIC_API_KEY=YOUR_ANTHROPIC_API_KEY
yaku --backend anthropic --to ko "Hello"

모델 재정의:

yaku --backend anthropic --model claude-sonnet-4-5-20250514 --to ko "Hello"

백엔드 간 전환

--backend 옵션은 설정된 백엔드를 단일 명령에 대해 재정의합니다. 각 로컬 백엔드는 자체 API 키가 필요합니다. yaku는 api-key가 설정되지 않고 YAKU_API_KEY도 설정되지 않은 경우 해당 제공자별 환경 변수(GOOGLE_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY)를 자동으로 확인합니다.

모든 키를 한 번 설정하고 자유롭게 전환:

export GOOGLE_API_KEY=your-gemini-key
export OPENAI_API_KEY=your-openai-key
export ANTHROPIC_API_KEY=your-anthropic-key

# 다른 백엔드의 출력 비교
echo "Hello" | yaku --backend gemini --to ko
echo "Hello" | yaku --backend openai --to ko
echo "Hello" | yaku --backend anthropic --to ko
echo "Hello" | yaku --backend hosted --to ko

hosted 백엔드는 API 키가 필요 없습니다.

참고

설정에 api-key가 설정되어 있거나 환경에 YAKU_API_KEY가 있으면, 제공자별 변수는 무시됩니다. yaku는 설정된 키를 모든 백엔드에 사용합니다. 제공자별 폴백을 사용하려면 api-key를 설정하지 마세요.

팁

일상 사용에는 로컬 백엔드 하나를 선택하여 기본값으로 설정하세요. 키 설정 없이 정교한 번역 품질을 원할 때는 --backend hosted를 사용하세요.

yaku config set backend gemini
yaku config set api-key YOUR_GEMINI_KEY

# 일반 사용 → Gemini
yaku --to ko "Hello"

# 빠른 비교 → hosted (키 불필요)
yaku --backend hosted --to ko "Hello"