後端

yaku 支援四種翻譯後端，每一種會將你的文字傳送到不同的 LLM 提供者。

可用後端

後端	預設模型	備註
`hosted`	伺服器端	零設定預設。精煉的語言對提示詞。
`gemini`	`gemini-2.5-flash`	可從 Google AI Studio 免費取得 API key。
`openai`	`gpt-4o-mini`	支援任何 OpenAI 相容 API（Groq、Together、DeepSeek、Ollama）。
`anthropic`	`claude-haiku-4-5-20251001`	透過 Anthropic Messages API 使用 Claude 模型。

所有後端使用 0.3 的 temperature，以確保一致、低變異的翻譯結果。搭配 --verbose 時，yaku 會回報 API 實際使用的模型版本（可能與你指定的別名不同）。

yaku 如何選擇後端

後端的解析順序如下：

--backend 選項 — 如有指定，永遠優先。
設定檔 backend 欄位 — 未傳入選項時使用。
預設值 — hosted。擁有 API key 不會改變預設值，你必須明確選擇自備 API 後端。

# 完全無設定 → 使用 hosted（預設）
yaku --to zh-TW "Hello"

# 已設定 API key，但未設定 backend → 仍使用 hosted
yaku config set api-key AIza...
yaku --to zh-TW "Hello"

# 明確選擇自備 API 後端以使用你的 API key
yaku config set backend gemini
yaku --to zh-TW "Hello"

# 用 --backend 選項逐次覆蓋
yaku --backend openai --to zh-TW "Hello"

託管服務後端

預設後端。使用精煉的語言對提示詞，翻譯品質高於自備 API 後端。詳見託管服務與方案的比較、方案等級和配額限制。

# 使用託管服務後端（永遠是預設值）
yaku --to zh-TW "Hello, how are you?"

自訂託管服務端點：

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

Gemini 後端

使用 Google 的 Gemini API。可從 Google AI Studio 免費取得 API key。yaku 會停用 Gemini 的思考模式以降低延遲和 token 成本 — 翻譯是指令遵循任務，不是推理任務。

# 設定
yaku config set api-key YOUR_GEMINI_API_KEY

# 或使用環境變數
export GOOGLE_API_KEY=YOUR_GEMINI_API_KEY

覆蓋模型：

yaku --model gemini-2.5-pro --to zh-TW "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 zh-TW "Hello"

OpenAI 相容提供者

使用 --api-base 指向任何相容端點：

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

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

# 本地 Ollama
yaku --backend openai \
  --api-base http://localhost:11434/v1 \
  --model llama3 \
  --to zh-TW "Hello"

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

覆蓋模型：

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

切換後端

--backend 選項可以覆蓋設定檔中的後端設定。每個自備 API 後端需要各自的 API key——yaku 會自動檢查對應供應商的環境變數（GOOGLE_API_KEY、OPENAI_API_KEY、ANTHROPIC_API_KEY），前提是未設定 api-key 且 YAKU_API_KEY 也未設定。

一次設好所有 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 zh-TW
echo "Hello" | yaku --backend openai --to zh-TW
echo "Hello" | yaku --backend anthropic --to zh-TW
echo "Hello" | yaku --backend hosted --to zh-TW

hosted 後端不需要 API key。

日常使用建議選定一個自備 API 後端設為預設，需要精調翻譯品質時用 --backend hosted 切換。

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

# 一般使用 → Gemini
yaku --to zh-TW "Hello"

# 快速比較 → 託管服務（不需要 key）
yaku --backend hosted --to zh-TW "Hello"