バックエンド

yakuは4つの翻訳バックエンドに対応しています。それぞれ異なる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 モデルを使用。

すべてのバックエンドは一貫性のある低分散の翻訳のためにtemperature 0.3を使用します。--verboseを使うと、APIが実際に使用したモデルバージョン（指定したエイリアスと異なる場合があります）が表示されます。

yakuのバックエンド選択ロジック

バックエンドは以下の優先順位で決定されます：

--backendオプション — 指定された場合は常に優先。
設定のbackendフィールド — オプション未指定の場合に使用。
デフォルト — hosted。APIキーを設定しても、デフォルトは変わりません。ローカルバックエンドを使うには明示的に選択する必要があります。

# 設定なし → hosted（デフォルト）を使用
yaku --to ja "Hello"

# APIキーを設定しても、バックエンド未設定 → やはりhostedを使用
yaku config set api-key AIza...
yaku --to ja "Hello"

# ローカルバックエンドを明示的に選択してAPIキーを使用
yaku config set backend gemini
yaku --to ja "Hello"

# コマンドごとに--backendオプションで上書き
yaku --backend openai --to ja "Hello"

ホステッドバックエンド

デフォルトのバックエンドです。言語ごとに調整されたプロンプトを使用し、ローカルバックエンドより高品質な翻訳を提供します。比較、プランの種類、クォータ制限はホステッドサービスとプランをご覧ください。

# ホステッドバックエンドを使用（常にデフォルト）
yaku --to ja "Hello"

ホステッドのエンドポイントをカスタマイズ：

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 ja "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 ja "Hello"

OpenAI互換プロバイダー

--api-baseで任意の互換エンドポイントを指定できます：

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

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

# ローカルOllama
yaku --backend openai \
  --api-base http://localhost:11434/v1 \
  --model llama3 \
  --to ja "Hello"

# DeepSeek
yaku --backend openai \
  --api-base https://api.deepseek.com/v1 \
  --model deepseek-chat \
  --to ja "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 ja "Hello"

モデルの上書き：

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

バックエンドの切り替え

--backendオプションは、設定されたバックエンドを1コマンドだけ上書きします。各ローカルバックエンドにはそれぞれのAPIキーが必要です — api-keyが設定されておらずYAKU_API_KEYも未設定の場合、yakuは解決されたバックエンドに対応するプロバイダー固有の環境変数（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 ja
echo "Hello" | yaku --backend openai --to ja
echo "Hello" | yaku --backend anthropic --to ja
echo "Hello" | yaku --backend hosted --to ja

hostedバックエンドはAPIキーを必要としません。

日常使いでは、1つのローカルバックエンドを選んでデフォルトに設定しましょう。キー設定なしで高品質な翻訳が必要な場合は--backend hostedを使ってください。

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

# 通常の使用 → Gemini
yaku --to ja "Hello"

# 比較 → hosted（キー不要）
yaku --backend hosted --to ja "Hello"