后端

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

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

# 明确选择自备 API 后端以使用你的 API key
yaku config set backend gemini
yaku --to zh-CN "Hello"

# 用 --backend 选项逐次覆盖
yaku --backend openai --to zh-CN "Hello"

托管服务后端

默认后端。使用精调的语言对提示词，翻译质量高于自备 API 后端。详见托管服务与方案的比较、方案等级和配额限制。

# 使用托管服务后端（永远是默认值）
yaku --to zh-CN "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-CN "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-CN "Hello"

OpenAI 兼容提供商

使用 --api-base 指向任何兼容端点：

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

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

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

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

覆盖模型：

yaku --backend anthropic --model claude-sonnet-4-5-20250514 --to zh-CN "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-CN
echo "Hello" | yaku --backend openai --to zh-CN
echo "Hello" | yaku --backend anthropic --to zh-CN
echo "Hello" | yaku --backend hosted --to zh-CN

hosted 后端不需要 API key。

日常使用建议选定一个自备 API 后端设为默认，需要精调翻译质量时用 --backend hosted 切换。

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

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

# 快速比较 → 托管服务（不需要 key）
yaku --backend hosted --to zh-CN "Hello"