콘텐츠로 이동
yaku 문서 v0.2.0

빠른 시작

yaku는 호스팅 백엔드로 바로 사용할 수 있습니다. API 키가 필요 없습니다. 자체 LLM API 키를 사용하려면 아래의 옵션 B를 참조하세요.

옵션 A: 호스팅 서비스 사용 (기본값)

섹션 제목: “옵션 A: 호스팅 서비스 사용 (기본값)”

  1. 번역해 보기

    설정 없이 yaku는 api.yakulang.com의 호스팅 서비스로 요청을 보냅니다:

    Terminal window
    yaku --to ko "Hello, world"

    출력:

    안녕하세요, 세계

  2. 기본 대상 언어 설정

    매번 --to를 입력하지 않아도 됩니다:

    Terminal window
    yaku config set default-target ko

    이제 간단히 실행할 수 있습니다:

    Terminal window
    echo "Hello, world" | yaku

  3. 파일 번역

    Terminal window
    yaku -f README.en.md -o README.md

    yaku는 .md 확장자를 감지하고 Markdown 구조(제목, 코드 블록, 링크)를 자동으로 보존합니다.

호스팅 서비스는 높은 품질의 번역을 위해 정교한 언어별 프롬프트를 사용합니다. 할당량 제한과 업그레이드 방법은 호스팅 서비스 & 플랜을 참조하세요.

옵션 B: 자체 API 키 사용

섹션 제목: “옵션 B: 자체 API 키 사용”

  1. API 키 설정

    yaku는 Gemini, OpenAI, Anthropic을 지원합니다. 하나를 선택하세요:

    Google AI Studio에서 무료 API 키를 받으세요.

    Terminal window
    yaku config set backend gemini
    yaku config set api-key YOUR_GEMINI_API_KEY

    또는 환경 변수로 설정:

    Terminal window
    export YAKU_BACKEND=gemini
    export GOOGLE_API_KEY=YOUR_GEMINI_API_KEY

  2. 기본 대상 언어 설정

    Terminal window
    yaku config set default-target ko

  3. 번역해 보기

    Terminal window
    echo "The meeting is scheduled for tomorrow at 10 o'clock." | yaku

    출력:

    회의는 내일 10시로 예정되어 있습니다.

빠른 예제

섹션 제목: “빠른 예제”
Terminal window
# 텍스트 직접 번역
yaku --to ko "Good morning"


# 소스 언어를 지정하여 번역
yaku --from ja --to ko "今日の会議は午後3時からです。"


# JSON i18n 파일 번역, 키 보존
yaku --to ko -f en.json -o ko.json


# 다른 언어로 작성한 글 다듬기
yaku --mode polish --to en "I want to inform that the deployment will be delay."


# 도메인 컨텍스트를 추가하여 용어 정확도 향상
yaku --to ko --context "요리 레시피" -f recipe.en.md


# 프로젝트 용어집 사용
yaku --to ko --glossary terms.yaml -f docs.en.md


# 모델 및 토큰 사용량 확인
yaku --verbose --to ko "Hello"

다음 단계

섹션 제목: “다음 단계”