Kin 能量站 API 开发文档

创建密钥

登录控制台，在 API Keys 页面创建以 kin_ 开头的密钥。新建密钥可以在控制台随时显示、复制或隐藏。

OpenCode、Cursor、Codex、Hermes、curl 等所有接入方式共用一个Base URL / 基础 URL（Claude Code 除外，见下方接入示例）：

https://kinneng.com/api/v1

OpenAI 兼容客户端可通过 GET https://kinneng.com/api/v1/models 读取当前支持的模型列表；该接口同样需要 Kin Key。

智能路由 Key

创建 Key 时选择“智能路由”：无需选择任何供应商，系统会综合 Engy、Chutes、GM、StreamLake、Novita、Decart 等多家供应商的 实时价格、速度与稳定性智能选择起始供应商，并在失败时自动切换， 不会影响计费精度。创建时还可以给 Key 加备注，方便区分用途。

固定提供商 Key

创建 Key 时选择“固定提供商”，可以把 Key 绑定到 Engy、Chutes、GM 、StreamLake、Novita、Decart 等任意一家供应商。这个 Key 的所有 请求都只走绑定那一家，用法和普通 Key 完全一样——不需要 指定提供商，也不支持在请求里临时切换。

如果请求的模型该供应商当前不提供，会返回明确的错误提示； 请求不会偷偷切换到其他供应商。适合想锁定某家渠道、给不同项目 或成员分配独立渠道的场景。

Chat Completions

最常见的 OpenAI 兼容接口，支持普通 JSON、SSE 流式输出、function tools、tool calls 和 tool 结果回传，适合 OpenAI SDK、Cursor、Hermes 与一般聊天应用。

POST https://kinneng.com/api/v1/chat/completions
Authorization: Bearer kin_xxx
Content-Type: application/json

{
  "model": "glm-5.2",
  "messages": [
    { "role": "user", "content": "你好" }
  ],
  "stream": true
}

Responses API

Responses 是 OpenAI 面向智能体的新协议。它把文本、推理、工具调用和多轮任务统一到一个接口中，也是 Codex 自定义供应商使用的协议。Kin 会原样传递 SSE 事件，并支持 function call 与 function_call_output 后续请求。

POST https://kinneng.com/api/v1/responses
Authorization: Bearer kin_xxx
Content-Type: application/json

{
  "model": "glm-5.2",
  "input": "介绍一下 Kin API",
  "tools": [],
  "stream": true
}

上游使用无状态 Responses 时，请在下一次请求中带回完整上下文；只有上游明确支持时才使用 previous_response_id。

Anthropic Messages 兼容入口

为 Claude Code 等 Anthropic 协议客户端提供 POST /api/v1/messages，接受 Authorization: Bearer 或 x-api-key。 这是第三方模型兼容模式；Claude Code 官方不保证非 Claude 模型的行为，升级客户端后应重新验证工具调用。

POST https://kinneng.com/api/v1/messages
x-api-key: kin_xxx
anthropic-version: 2023-06-01
Content-Type: application/json

{
  "model": "glm-5.2",
  "max_tokens": 1024,
  "messages": [
    { "role": "user", "content": "你好" }
  ],
  "stream": true
}

开发工具接入

Codex · 3 步接入

/bin/bash -c "$(curl -fsSL https://kinneng.com/install-codex)"

完成后可在 Codex 的模型菜单中查看并自由切换 Kin 模型。如未看到新目录， 请升级 Codex，并完全退出后重新打开。

/bin/bash -c "$(curl -fsSL https://kinneng.com/restore-codex)"

model = "glm-5.2"
model_provider = "custom"
model_catalog_json = "/Users/你的用户名/.codex/kin-codex-models.json"

[model_providers.custom]
name = "Kin"
base_url = "https://kinneng.com/api/v1"
env_key = "KIN_API_KEY"
wire_api = "responses"

Cursor

在 Cursor Settings → Models 中填写 Kin Key，启用 Override OpenAI Base URL，填写 https://kinneng.com/api/v1，然后添加 glm-5.2 或 qwen3.6-35b-a3b。Cursor 的 Tab、部分内置 Agent 与后台功能仍可能使用 Cursor 自己的服务。

OpenCode

1. 先在控制台创建 Key：控制台 → API Keys → 创建 API Key （默认智能路由即可，不需要选供应商）。

2. 打开 OpenCode 的“自定义提供商”配置 （opencode 中打开模型/提供商设置），按下面逐项填写：

提供商 ID: kin
显示名称: Kin
基础 URL: https://kinneng.com/api/v1
API 密钥: kin_你的Key
模型 ID: glm-5.2
名称: GLM-5.2

也可以直接把下面内容写到 ~/.config/opencode/opencode.jsonc：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "kin": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://kinneng.com/api/v1"
      },
      "models": {
        "glm-5.2": { "name": "GLM-5.2" }
      }
    }
  }
}

3. 重启 OpenCode，把当前模型切换到 kin提供商下的模型，即可开始对话。

容易踩坑：“模型 ID”必须是 GET /api/v1/models 返回的 id（如 inclusionai/ling-3.0-flash）， 不是模型页上的显示名称；填错会返回 Unsupported provider or model。

Hermes

在聊天会话外运行 hermes model，选择 Custom endpoint， Base URL 填 https://kinneng.com/api/v1，API mode 选择 Chat Completions，再填写 Kin Key 与准确模型 ID。Hermes 专门教程暂未上线。

Claude Code（实验性）

使用 Messages 兼容入口，并把 Kin Key 作为网关令牌：

ANTHROPIC_BASE_URL=https://kinneng.com/api
ANTHROPIC_AUTH_TOKEN=kin_xxx
ANTHROPIC_MODEL=glm-5.2
ANTHROPIC_DEFAULT_SONNET_MODEL=glm-5.2
ANTHROPIC_DEFAULT_OPUS_MODEL=glm-5.2
ANTHROPIC_DEFAULT_HAIKU_MODEL=glm-5.2

可用模型

可通过 GET /api/v1/models 查询当前全部可用模型 （100+ 款，持续更新），模型与价格随上游目录自动同步。控制台的 “浏览模型”页可以按品牌浏览，模型详情页会列出每家供应商的价格、 延迟、吞吐量与在线率。

常用示例：

完整模型列表以 GET /api/v1/models 为准。

注意：API 调用用的是模型 ID（ GET /api/v1/models 返回的 id 字段），一般由品牌前缀/模型名组成，例如 inclusionai/ling-3.0-flash。OpenCode、Cursor、 Codex、Hermes、Claude Code 以及 curl 等所有接入方式里填的 模型名/模型 ID 都是同一个。模型页上的“Ling-3.0-flash”只是 显示名称，不能直接用于请求；每个模型详情页的“模型 ID” 字段会显示完整 ID。

限制与错误

所有接口均只允许控制台创建的 API Key 和受支持模型，每个 Key 每分钟最多 300 次请求，每个账户所有 Key 合计最多 10 个并发请求，请求体最大 8MB。余额不足返回 402，限流返回 429，上游整体不可用返回 503 或 504。