託管服務與方案

api.yakulang.com 託管後端是所有 yaku 使用者的預設選項。不需要任何設定，且在許多語言對上能產出比自備 API 後端更高品質的翻譯。

為什麼選擇託管服務？

	託管服務（`api.yakulang.com`）	自備 API（Gemini、OpenAI、Anthropic）
設定	不需要——開箱即用	需要 API key 和 `backend` 設定
提示詞品質	精調過的語言專屬規則，搭配多種語言對的 few-shot 範例	通用、不分語言的規則
費用	含免費方案	你直接付費給 LLM 供應商
自訂提示詞	不支援（`--prompt` 會被忽略）	支援

適合使用託管服務的情境： 你想要最佳翻譯品質且不想做任何設定。

適合使用自備 API 後端的情境： 你需要自訂提示詞、超長文字（超過 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-TW -f large-document.md