호스팅 서비스 & 플랜

api.yakulang.com의 호스팅 백엔드는 모든 yaku 사용자의 기본값입니다. 설정이 필요 없으며 많은 언어 쌍에서 로컬 백엔드보다 높은 품질의 번역을 제공합니다.

왜 호스팅인가?

	호스팅 (`api.yakulang.com`)	로컬 (Gemini, OpenAI, Anthropic)
설정	없음 — 바로 사용 가능	API 키와 `backend` 설정 필요
프롬프트 품질	정교한 언어별 규칙과 다수 언어 쌍의 퓨샷 예제	보편적, 언어에 구애받지 않는 규칙만
비용	무료 플랜 포함	LLM 제공자에 직접 지불
커스텀 프롬프트	미지원 (`--prompt` 무시)	지원

호스팅을 사용하면 좋은 경우: 설정 없이 최상의 번역 품질을 원할 때.

로컬을 사용하면 좋은 경우: 커스텀 프롬프트, 매우 긴 텍스트(50,000자 이상)가 필요하거나 외부 서비스를 피하고 싶을 때.

플랜

	익명	무료	유료
일일 요청	50	50	무제한
월간 요청	100	300	무제한
요청당 최대 글자 수	5,000	10,000	50,000
접근 방법	설정 불필요	`yaku login`	출시 예정

모든 플랜은 동일한 정교한 프롬프트와 번역 품질을 사용합니다. 차이점은 사용량 제한뿐입니다.

사용량 확인

yaku quota를 실행하여 현재 플랜과 사용량을 확인합니다:

yaku quota

익명 사용자 출력:

Plan:     Anonymous
Daily:    3 / 50 requests
Monthly:  15 / 100 requests
Max text: 5,000 chars per request

yaku는 stderr에 힌트도 출력합니다: Log in for higher limits: yaku login

무료 플랜 사용자 출력:

Plan:     Free
Daily:    12 / 50 requests
Monthly:  45 / 300 requests
Max text: 10,000 chars per request

플랜 업그레이드

익명 → 무료

yaku login을 실행하여 브라우저로 인증합니다. 즉시 익명에서 무료 플랜으로 업그레이드됩니다:

yaku login
# 브라우저가 열려 인증을 완료합니다

yaku whoami
# Logged in as Jane Doe ([email protected], github)

GitHub 또는 Google로 인증할 수 있습니다. 인증 정보는 ~/.config/yaku/.credentials에 저장됩니다.

무료 → 유료

유료 플랜은 아직 제공되지 않습니다. 출시되면 계정 대시보드에서 업그레이드할 수 있습니다.

할당량 오류

요청 한도 초과

일일 또는 월간 요청 한도에 도달하면:

Error: Daily limit reached (50/50). Run "yaku login" for higher limits, or use your own API key: yaku config set api-key
More info: https://docs.yakulang.com/guides/hosted-service/

이미 로그인한 경우, 자체 API 키 사용을 제안합니다:

Error: Daily limit reached (50/50). Use your own API key for unlimited usage: yaku config set api-key
More info: https://docs.yakulang.com/guides/hosted-service/

옵션:

로그인 — yaku login으로 익명(월 100건)에서 무료(월 300건)로 업그레이드합니다.
자체 API 키 사용 — 로컬 백엔드에서 yaku config set api-key <key>를 설정하면 yaku의 할당량 제한이 없습니다.
대기 — 일일 한도는 UTC 자정에 초기화됩니다.

텍스트 너무 길음

요청당 글자 수 제한을 초과하면:

Error: input too long (8000 chars). Hosted service limit: 5000 chars per request

옵션:

로그인 — yaku login으로 익명(5,000자)에서 무료(10,000자)로 업그레이드합니다.
텍스트 분할 — 큰 파일을 작은 조각으로 나눕니다.
로컬 백엔드 사용 — 로컬 백엔드에는 yaku의 글자 수 제한이 없습니다.

# 큰 텍스트에 로컬 백엔드 사용
yaku --backend gemini --to ko -f large-document.md