Provider 配置
配置 OpenAI
OpenAI 官方账号 + Responses wire 的标准配置。
概览
OpenAI 是 Kition 最早支持也是最稳的 provider。我们用的是 Responses API（/v1/responses），而不是更老的 Chat Completions — 它原生支持 reasoning tokens、流式 tool calls 与 multimodal 输入，跟 Kition Agent 的内部消息格式 1:1 对应。
所有 GPT-5 / GPT-5.1 / o-series 模型都跑在这条 wire 上。Key 配置好之后存进 macOS Keychain / Windows Credential Manager / Linux Secret Service，磁盘上不会有明文。
生成 API Key
- 登录 platform.openai.com → 左侧 API keys
- 点 Create new secret key，命名 "Kition Desktop"
- 复制
sk-proj-...开头的字符串 — 离开页面后无法再看到 - 建议为这个 Key 单独建一个 Project 并设月度限额（Settings → Limits）
Kition 里添加
打开 Settings → Providers → Add Provider → OpenAI。模板会预填好 baseURL 和 wire，你只需要粘 key、选默认模型。
{
"name": "openai",
"baseURL": "https://api.openai.com/v1",
"apiKey": "sk-proj-...",
"wire": "responses",
"defaultModel": "gpt-5.1",
"headers": {
"OpenAI-Beta": "responses=v1"
}
}认证 header
Kition 在每个请求上自动附加 Authorization: Bearer <key>，无需手动配置。如果你走的是企业的 OpenAI 部署或 Azure-style 网关，可能需要额外加 api-key header — 见下面的自定义 Provider 文档。
curl https://api.openai.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.1","input":"ping"}'推荐模型
gpt-5.1— 当前主力，平衡质量与延迟，适合日常对话与 Agentgpt-5— 老一代旗舰，便宜一档，适合大批量摘要gpt-5.1-mini— 长上下文 / 索引任务的快速档o4系列 — 显式 reasoning，留给数学 / 复杂规划
常见错误
401 invalid_api_key— Key 错或被吊销，重新粘一遍403 model_not_found— 你的 OpenAI 账号还没解锁这个模型，去 Limits 页申请429 rate_limit_exceeded— 触发了 RPM/TPM，Kition 会自动指数退避重试 3 次429 insufficient_quota— 账单余额不足，不是限速 — 去 Billing 充值400 context_length_exceeded— 上下文超长，缩短 prompt 或切到长上下文模型
限速与计费
新账号的 Tier 1 大概是 500 RPM / 200k TPM — 对单个桌面用户绰绰有余。如果你跑长任务（深度研究、批量索引）容易撞 TPM 上限，建议升 Tier 2 或在 Settings → Agent → Concurrency 把并发限到 2。
Kition 不会预扣费、不会保存账单数据 — 所有费用直接计在你的 OpenAI 账单里，可以在 platform.openai.com 的 Usage 页实时看到。