Kin 能量站 API 开发文档

创建密钥

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

OpenAI 兼容客户端与 curl 请求共用一个Base URL / 基础 URL：

https://kinneng.com/api/v1

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

Kin API Key

创建一把 Kin Key，即可调用当前在售模型。可以为 Key 添加备注，按项目区分用途，并随时撤销。

OpenAI 兼容 SDK

先在本机环境变量中设置 KIN_API_KEY，再配置 Kin Base URL。不要把密钥写进网页前端代码。

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://kinneng.com/api/v1",
    api_key=os.environ["KIN_API_KEY"],
)
response = client.chat.completions.create(
    model="glm-5.2",
    messages=[{"role": "user", "content": "Hello"}],
    max_tokens=1024,
)
print(response.choices[0].message.content)

流式请求设置 stream=True，逐块读取结果；需要流式用量时传 stream_options={"include_usage": True}。工具调用后保留调用 ID，在下一次请求中回传工具结果。

已开放接口

下列路径均使用 https://kinneng.com，认证为 Authorization: Bearer YOUR_KIN_KEY；Messages 也接受 x-api-key。除视频下载外，请求使用 JSON。

按 GET /api/v1/models 中的 protocols 与 architecture 字段选择接口和输入类型。视频生成模型使用 videos 接口；当前公开 API 以上表为准。

Chat Completions

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

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 面向智能体的新协议。它把文本、推理、工具调用和多轮任务统一到一个接口中。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 兼容入口

为 Messages 协议客户端提供 POST /api/v1/messages，接受 Authorization: Bearer 或 x-api-key。 兼容行为取决于所选模型；升级客户端后应重新验证工具调用。

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
}

推理强度

Chat Completions 可传 reasoning_effort：none、minimal、low、medium、high、xhigh、max。不同模型对同一档位的表现不同；GLM-5.3 和 GLM-5.3-Flash 关闭思考时仍会进行最低强度的推理。

{
  "model": "glm-5.2",
  "reasoning_effort": "high",
  "messages": [{"role": "user", "content": "Explain your solution"}],
  "max_tokens": 2048
}

Messages 使用 thinking: {"type": "disabled"} 关闭思考。输出上限应为推理和最终答案留出空间；max_tokens 过小可能导致结果提前结束。

提示词缓存

把可复用内容放在提示词开头。Chat Completions 可用 prompt_cache_key 对相关请求分组。缓存命中不保证发生，以 usage 中实际返回的缓存 Tokens 为准。

{
  "model": "glm-5.2",
  "prompt_cache_key": "support-prefix-v1",
  "messages": [
    {"role": "system", "content": "You are a helpful support assistant."},
    {"role": "user", "content": "Hello"}
  ]
}

缓存键使用不含个人信息或凭据的标识。当前缓存输入单价可在模型目录查询。

图片输入

选择 architecture.input_modalities 包含 image 的模型。图片使用内联 Base64，不传远程链接。每次请求的图片按 Base64 解码后合计最多 12 MiB，最多 100 个图片块，包含历史消息和工具返回中的图片。整个 JSON 请求体（含 Base64 文本）上限为 20 MiB（20,971,520 字节）；模型上下文长度另行检查。

{
  "model": "moonshotai/kimi-k3",
  "messages": [{"role": "user", "content": [
    {"type": "text", "text": "Describe this image"},
    {"type": "image_url", "image_url": {
      "url": "data:image/png;base64,REPLACE_WITH_IMAGE_BASE64"
    }}
  ]}],
  "max_tokens": 1024
}

Messages 图片块使用 source.type=base64，并填写 source.media_type 与 source.data。示例模型能否接收图片以实时目录为准；图片理解和视频生成是不同能力。

可用模型

可通过 GET /api/v1/models 查询当前全部可用模型 ，模型与价格定期更新。控制台的“浏览模型”页可以按公司浏览， 模型详情页展示 Kin 价格、上下文与服务指标。

常用示例：

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

注意：API 调用用的是模型 ID（ GET /api/v1/models 返回的 id 字段），一般由品牌前缀/模型名组成，例如 qwen/qwen3.8-27b。兼容客户端和 curl 请求中填写的 模型名/模型 ID 都是同一个。模型页上的“Qwen 3.8 27B”只是 显示名称，不能直接用于请求；每个模型详情页的“模型 ID” 字段会显示完整 ID。

视频生成

MiniMax-H3 · minimax-h3 · 768P · 4–15 秒

创建任务后查询状态，完成后通过 Kin 下载视频。每次新生成使用独立的 Idempotency-Key；重试时保持同一 Key 和相同输入，避免重复生成。运行期间占用余额，完成后按视频秒数只结算一次，失败不扣费。

curl https://kinneng.com/api/v1/videos \
  -H "Authorization: Bearer YOUR_KIN_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: video-example-001" \
  -d '{"model":"minimax-h3","prompt":"A red ball rolls across a white floor","seconds":4,"resolution":"768P"}'

请及时下载并保存到本地。Kin 不承诺永久保存视频，历史记录仍在也不代表文件始终可下载。

GET /api/v1/videos/VIDEO_ID · GET /api/v1/videos/VIDEO_ID/content · GET /api/v1/videos

可选 image 字段为内联 PNG/JPEG/WebP data URI。所有接口需要 Kin Key 或控制台会话，视频仅所属账户可访问。请求上限 8 MB；Kin 不设置创建、查询/下载频次或账户并发限额；实际能力受模型服务与运行平台约束。

可选 ratio：16:9、9:16、1:1、4:3、3:4、21:9 或 adaptive（匹配首帧）。使用同一 Idempotency-Key 重试时，画幅参数也须保持一致。试用页面可在“视频参数”中选择时长与画幅。

状态为 queued、running、succeeded、failed、pending_confirmation。等待确认时保留任务编号，核对结果前避免另建任务。usage.video_seconds 为计费时长，usage.charged_cny 为已结算消费；当前每秒单价见 GET /api/v1/models。

使用 MiniMax H3 及生成内容须遵守适用许可证与可接受使用政策，请确保授权覆盖您的业务及用户。Kin 不以调用服务器所在国家判定接口准入或使用授权。 查看完整许可证

DELETE /api/v1/videos/{id} — 生成与结算结束后可删除成功或失败任务。删除后不再显示于账户历史，查询和下载返回404；保留账务记录，已消费费用不退款。重复删除成功，其他账户返回404，未结束任务返回409。每Key每分钟60次；已删除任务的幂等Key不能用来重新生成。

用量、余额与隐私

文本按实际用量高精度人民币结算，不设每次请求最低费用，页面金额仅作展示舍入；视频每秒人民币单价向上取到分，再按生成秒数结算。进行中的请求占用可用余额，结算后一次性扣除消费。当前 Kin 单价由 GET /api/v1/models 返回。

字段是否返回取决于模型和响应。流式用量通常在结束时返回，不要用尚未结束的流计算账单。已结算消费以控制台记录为准。

Kin 在账户用量中记录模型、用量、消费与时间。数据处理范围详见隐私政策。 隐私政策

限制与错误

所有接口均只允许控制台创建的 API Key 和受支持模型。Kin 不设置文本/视频生成请求频次或账户并发限额；实际处理能力受模型服务与运行平台约束，不保证无限并发。文字/看图接口请求体最大 20 MiB（20,971,520 字节）；图片解码后合计最多 12 MiB、100 个图片块，包含历史和工具返回。视频创建请求体仍为 8,000,000 字节。余额不足返回 402，模型繁忙可能返回 429，模型服务不可用或超时返回 502、503 或 504。