iKun API 平台基本信息

iKun API 提供面向 AI 客户端和程序调用的模型接口。本页只说明平台入口、接入参数和通用规则；具体软件怎么配置，请进入对应的客户端接入页面。

平台定位

这套文档面向正在使用 iKun API 的用户，主要解决四类问题：

• 第一次接入时，需要准备哪些参数；
• Codex、Claude Code、Cherry Studio 等客户端应该怎样配置；
• GPT、Claude 和图片模型应如何选择令牌分组；
• 调用失败后，怎样根据状态码和报错信息定位原因。

它是一套静态使用文档，不是在线问答或 API 调试工具。模型可用情况、分组名称和倍率可能调整，实时信息以 API 控制台为准。

基本信息

项目	信息
平台名称	iKun API
API 控制台	https://api.monkey-tools.cn
通用 API 地址	https://api.monkey-tools.cn
OpenAI 兼容 API 前缀	https://api.monkey-tools.cn/v1
快速生图站	https://chat2img.monkey-tools.cn
图片 API 调试文档	https://ikun-api.apifox.cn
用户交流与软件下载	QQ 群 693655685

IMPORTANT

有些客户端要求填写站点根地址，有些要求填写 /v1，还有些直接要求完整接口路径。请优先使用对应客户端页面给出的地址，不要把同一个地址机械地套用到所有工具。

四个核心接入参数

参数	作用	从哪里确认
API Key	证明调用身份并关联账户额度	API 控制台的“令牌管理”
Base URL	指定请求发送到哪个接口入口	本页或对应客户端教程
模型名称	指定本次调用的模型	API 控制台当前可用模型
令牌分组	决定该令牌可以访问哪些模型和渠道	创建或编辑令牌时选择

每个令牌绑定一个分组。令牌分组必须支持目标模型，例如 Claude 分组用于 Claude 系列模型，图片分组用于图片模型。只填对 API Key 和地址，但模型与分组不匹配，调用仍然会失败。

常用接口地址

不同客户端支持的协议不同，常见地址包括：

https://api.monkey-tools.cn
https://api.monkey-tools.cn/v1
https://api.monkey-tools.cn/v1/chat/completions
https://api.monkey-tools.cn/v1/responses

• 客户端要求填写 Base URL 时，先按该客户端教程选择根地址或 /v1。
• 客户端要求选择协议时，确认它使用 OpenAI Chat Completions、Responses 还是 Anthropic 兼容协议。
• 程序直接调用接口时，使用与请求格式匹配的完整路径。
• 模型名必须与当前分组和所选协议同时兼容。

第一次接入流程

1. 登录 API 控制台。
2. 在“令牌管理”创建 API Key，并绑定支持目标模型的分组。
3. 在控制台确认当前可用的模型名称。
4. 从左侧“客户端接入”或“图片生成”选择对应教程。
5. 只配置一个令牌、一个地址和一个模型，先发送最小测试请求。
6. 测试通过后，再增加其他模型、客户端或高级配置。

模型与分组隔离

平台的 GPT 与 Claude 主线路分开调度，一类模型出现问题时，另一类模型不一定同时受影响。需要同时使用多类模型时，建议分别创建令牌并绑定对应分组，排障时也更容易确认问题范围。

订阅与费用

订阅期间，账户可以使用对应的订阅分组；部分自营分组可能提供不同倍率。具体可用分组、倍率和扣费结果以 API 控制台实时展示为准。

需要进一步了解费用时，可查看：

• 缓存命中率说明
• 模型成本计算
• 用户用量案例

安全与服务边界

• 不要公开 API Key，也不要把它提交到 Git 仓库或发在截图中。
• 不要在提示词、附件或代码中提交不必要的敏感信息。
• API 请求会受到客户端协议、令牌分组、模型渠道、网络和上游服务状态等因素影响。
• 平台和上游服务都可能发生临时故障，单次不可用不代表所有模型或所有分组同时不可用。
• 数据处理与账户规则请查看 iKun API 隐私政策和iKun API 用户协议。

出错时先检查

1. API Key 是否有效，是否还有可用额度；
2. 令牌绑定的分组是否支持目标模型；
3. Base URL 和接口路径是否符合当前客户端要求；
4. 模型名称和协议是否匹配；
5. 网络代理或客户端旧配置是否造成冲突。

仍然失败时，前往 API 常见错误排查，并保留请求时间、模型、令牌分组和脱敏后的 Request ID。