LLM 供應商
每個翻譯管線 — translate-ui、translate-docs、translate-json 與 translate-svg — 都透過相同的供應商無關用戶端將文字傳送至 LLM。在任何這些指令執行之前,請在 ai-i18n-tools.config.json 中設定至少一個供應商,並在您的環境或 .env 中設定對應的API 金鑰(除了 Ollama 之外的內建預設值)。init 會寫入起始的 provider / providers 區塊;您仍須為使用中的預設值提供憑證。
您只需在設定檔中設定一次要呼叫哪個 API 端點;所有翻譯指令都會共用該設定和相同的 SQLite 快取。該提供者會嘗試哪些模型則是另一個步驟:AI 模型。
CLI 從頂層 provider 鍵(或當只設定一個時,providers 中的唯一條目)解析活動供應商。每個供應商區塊列出一個有序的 translationModels 備用鏈;內建預設值會自動繼承 baseUrl 和 API 鍵環境變數(必要時可針對每個供應商覆寫它們)。
內建供應商
預設供應商鍵只需 translationModels — 基本 URL 和 API 鍵環境變數會自動填入:
| 供應商 | API 金鑰環境變數 | 基礎 URL |
|---|---|---|
alibaba | ALIBABA_API_KEY | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
anthropic | ANTHROPIC_API_KEY | https://api.anthropic.com/v1 |
apikeyfan | APIKEYFAN_API_KEY | https://api.apikey.fan/v1 |
cerebras | CEREBRAS_API_KEY | https://api.cerebras.ai/v1 |
cheaperinference | CHEAPERINFERENCE_API_KEY | https://api.cheaperinference.com/v1 |
deepseek | DEEPSEEK_API_KEY | https://api.deepseek.com |
gemini | GOOGLE_API_KEY | https://generativelanguage.googleapis.com/v1beta/openai |
groq | GROQ_API_KEY | https://api.groq.com/openai/v1 |
mistral | MISTRAL_API_KEY | https://api.mistral.ai/v1 |
nvidia | NVIDIA_API_KEY | https://integrate.api.nvidia.com/v1 |
ollama | (無) | http://localhost:11434/v1 |
openai | OPENAI_API_KEY | https://api.openai.com/v1 |
openrouter | OPENROUTER_API_KEY | https://openrouter.ai/api/v1 |
xai | XAI_API_KEY | https://api.x.ai/v1 |
對於任何非預設鍵,請在設定中明確設定 baseUrl 和 apiKeyEnv。
在您的環境中設定作用中提供者的 API 金鑰,或者在尚未設定任何提供者 API 金鑰時,於與 ai-i18n-tools.config.json 相關的 .env / .env.local 中設定。CLI 會列印它從這些檔案讀取的變數名稱。請參閱環境變數。
零資料保留 (較便宜的推論)
providers.cheaperinference.zeroDataRetention 為選用,預設為關閉。當此專案必須僅透過不保留提示的供應商傳送提示時,請設定此項。
"cheaperinference": {
"zeroDataRetention": true,
"translationModels": ["gemini-2.5-flash", "deepseek-v4-flash"]
}啟用此旗標後,每個聊天請求都會包含 "zdr": true,且 list-models、check-models 和 suggest-models (包括儀表板的「模型」分頁) 會讀取 GET /v1/models?zdr=true。該目錄會列出零資料保留請求可使用的模型,並以零資料保留價格計費。check-models 會將該目錄中遺失的 ID 視為無效。此旗標不會為目錄中未列出的模型建立路由。請從 translationModels、uiModels 或 localeModels 中移除該 ID。
當 Cheaper Inference 帳戶不需要零資料保留時,請保持旗標關閉。如果帳戶已啟用資料保護,Cheaper Inference 仍會拒絕沒有零資料保留路由的模型。錯誤會指出該模型。若要保留帳戶政策,請將 zeroDataRetention 設定為 true 並切換到零資料保留目錄中的模型。若要保留被拒絕的模型,請在該頁面上關閉零資料保留。備援鏈會接著嘗試下一個已設定的模型。
模型
選擇模型、備援清單,以及 suggest-models、check-models、list-models 和 bench-models 的相關說明請見 AI 模型。
多個供應商
當配置了多個供應商時,設定頂層 provider 鍵以選擇預設值。無需編輯配置即可在每次運行時切換:
npx ai-i18n-tools translate-docs -P anthropic
npx ai-i18n-tools bench-models -P deepseek每個提供者區塊可定義自己的 translationModels、選用的 uiModels 和 localeModels、maxTokens、temperature,以及 requestTimeout(秒)或 requestTimeoutMs。提供者上的逾時會覆寫頂層的 requestTimeout / requestTimeoutMs。舊式頂層 openrouter 區塊仍會被接受,並在載入時自動遷移至 providers.openrouter。
選用 pricing 和 modelPricing 會設定每百萬個權杖的美元費用 (inputPerMTokens 和 outputPerMTokens),當提供者省略 usage.cost 時。pricing 是全提供者預設值;modelPricing 項目會覆寫單一模型 ID 的該值。OpenRouter 和 Cheaper Inference 已傳回每次呼叫的成本,因此請在這些提供者上將兩者都保持未設定。提供者報告的成本會按原樣保留。此金額包含在翻譯摘要、usage 和 使用量與成本 中。
在同一份文件上使用四個供應商的可執行範例,包含範例費率:examples/multi-provider。
延伸參考
- AI 模型 — 排名候選清單、備援清單以及模型指令。
- 設定 —
provider與providers— 預設表格、自訂端點、請求逾時、成本費率、Cheaper Inference 零資料保留、OpenRouter 特定行為。 - 架構 — LLM 用戶端 — 模型備援、批次處理和成本報告的內部運作方式。
- 環境變數 — API 金鑰環境變數以及基礎 URL 覆寫。