托管服务与方案

api.yakulang.com 托管后端是所有 yaku 用户的默认选项。不需要任何配置，且在许多语言对上能产出比自备 API 后端更高质量的翻译。

为什么选择托管服务？

	托管服务（`api.yakulang.com`）	自备 API（Gemini、OpenAI、Anthropic）
配置	不需要——开箱即用	需要 API key 和 `backend` 配置
提示词质量	精调过的语言专属规则，搭配多种语言对的 few-shot 示例	通用、不分语言的规则
费用	含免费方案	你直接付费给 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
# 以 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 key：

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 key — yaku config set api-key <key> 搭配自备 API 后端，没有 yaku 的配额限制。
等待 — 每日限制在 UTC 午夜重置。

文本过长

当文本超过每次请求的字符上限时：

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

解决方式：

登录 — yaku login 将匿名（5,000 字符）升级为免费（10,000 字符）。
分割文本 — 将大文件拆成较小的片段。
使用自备 API 后端 — 自备 API 后端没有 yaku 的字符限制。

# 大型文档改用自备 API 后端
yaku --backend gemini --to zh-CN -f large-document.md