Kimi
在 Kimi Code CLI 中使用 aicentos —— 透過 config.toml 註冊 OpenAI 相容 provider
最後更新於:
Kimi Code CLI 允許把任意 OpenAI 相容服務註冊成 provider。把 base_url 指向 aicentos、填入 API Key,就能在終端機介面裡直接呼叫 aicentos 接入的模型。
準備工作
先在控制台「API Key」頁面為 Kimi Code 建立一個專用 Key(建議命名 kimi-cli,方便追蹤用量)。
- 控制台:https://aicentos.com
- 建立 Key:https://aicentos.com/keys
- 錢包儲值:https://aicentos.com/wallet
- 文件站:https://docs.aicentos.com
設定檔預設位於 ~/.kimi/config.toml,首次執行 Kimi Code 時會自動建立。
需要填寫的設定
| 欄位 | 值 |
|---|---|
| provider 類型 | openai_legacy(Chat Completions 協定) |
| base_url | https://aicentos.com/v1 |
| api_key | 控制台建立的 Key |
| model | 控制台「模型廣場」中的模型名稱 |
如果 aicentos 側走的是 Responses 協定,把類型換成 openai_responses 即可。
設定步驟
開啟 ~/.kimi/config.toml,追加一個自訂 provider 和一個模型別名:
default_model = "aicentos-gpt-4o"
[providers.aicentos]
type = "openai_legacy"
base_url = "https://aicentos.com/v1"
api_key = "sk-你的Key"
[models.aicentos-gpt-4o]
provider = "aicentos"
model = "gpt-4o"
max_context_size = 128000- provider 名(
aicentos)和模型別名(aicentos-gpt-4o)都可以自訂,default_model裡寫的是別名,不是伺服器端模型 ID。 - 別名裡如果帶
.(例如gpt-4.1),TOML 裡必須加引號:[models."gpt-4.1"],否則.會被當成表的分隔符。 - 不想手寫 TOML 的話,在 TUI 裡輸入
/provider開啟供應商管理器,在[ Add New Platform ]一行按 Enter,按精靈指示新增。
也可以只走環境變數(對 openai_legacy / openai_responses 類型生效):
export OPENAI_BASE_URL="https://aicentos.com/v1"
export OPENAI_API_KEY="sk-你的Key"測試
啟動 kimi,在 TUI 裡傳送一句簡單提示詞,能正常回應即接入成功。用 /model 確認目前選中的是剛才設定的別名。
注意事項
- provider 憑證按
api_key欄位 >[providers.<name>.env]子表 > 啟動報錯 的順序解析;除openai_legacy/openai_responses外,設定檔裡的憑證不會從 shell 環境變數自動補齊。 type = "kimi"是給 Moonshot 官方端點用的,接入 aicentos 請用openai_legacy或openai_responses。max_context_size不要填低於模型實際視窗的值,填小了會提前觸發上下文壓縮。- Base URL 只填到
/v1,不要補成/v1/chat/completions完整路徑。 - 模型名稱以控制台「模型廣場」為準(參考 支援的模型)。