开始前准备
三种方式使用同一套 API Key 和模型权限。先完成下面两项准备,后续步骤会更顺利。
1. 使用 CC Switch 一键导入
如果你使用 Claude Code、Codex 或 Gemini CLI,推荐先使用 CC Switch 导入配置,避免手动编辑多个配置文件。
- 1安装并打开 CC Switch。
- 2在 API Key 页面找到要使用的密钥,打开操作菜单并选择 CC Switch 导入。
- 3选择目标客户端和模型,检查服务地址与模型 ID。
- 4确认导入并在 CC Switch 中启用配置,然后重启客户端。
2. 直接在网页端开启对话
不想配置本地客户端时,可以直接打开网页对话。进入后选择模型,发送一条简短消息即可确认 API Key 和模型是否可用。
3. 手动配置客户端
对于支持自定义 Base URL、API Key 和模型 ID 的客户端,可以手动填写配置。具体字段名称以客户端自身文档为准。
| 配置项 | 填写内容 |
|---|---|
Base URL | https://ikun.love/v1 |
API Key | 填写在 API Key 页面创建的密钥,不要把密钥提交到代码仓库。 |
Model ID | 填写模型列表中的完整模型 ID。 |
cURL / OpenAI Compatible
curl "https://ikun.love/v1/chat/completions" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "your-model-id",
"messages": [{"role":"user","content":"你好"}]
}'验证与排错
- 1重启客户端或重新打开网页对话,确保新配置已经被读取。
- 2发送一条简短测试消息,并在使用日志中确认请求状态和模型。
- 3如果返回 401,检查 API Key 是否过期、是否多了空格,以及客户端使用的鉴权字段是否正确。
- 4如果返回 404,检查 Base URL 是否重复拼接 /v1,并确认模型支持当前请求协议。
不要混用协议请求体
OpenAI Chat Completions 使用
messages,Responses 使用 input,Claude Messages 使用 messages 和 max_tokens。协议和请求体必须与客户端配置保持一致。