kaimid developer docs

开发者文档

使用 OpenAI 兼容接口接入恺米聚合 kaimid，统一调用多模型、多供应商能力。本文档只保留接入所需信息，正文使用深色字体，优先保证可读性。

快速开始

替换 API Key 后即可直接调用 OpenAI 兼容接口。

curl https://ailab.folhj.online/v1/chat/completions \
  -H "Authorization: Bearer $KAIMID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"mimo-2.5-pro","messages":[{"role":"user","content":"你好"}]}'

认证

所有 `/v1/*` API 使用 Bearer Token：`Authorization: Bearer $KAIMID_API_KEY`。 API Key 可在开发者控制台创建、轮换、吊销，并支持 IP 白名单、模型白名单和消费限制。

模型说明

访问 `/v1/models` 获取当前 API Key 可见模型；访问 `/models` 查看模型广场中的能力、价格、健康状态和示例。

计费

平台优先使用上游官方 usage 计费；缺少官方 usage 时使用估算并标记估算状态。流式请求首个 chunk 返回后即进入计费事件，客户端中断会按已生成内容估算扣费。

错误码

401 API Key 缺失、无效、过期或吊销。

402 租户钱包余额不足。

403 IP、模型或权限不允许。

429 请求过于频繁或上游限流。

502 上游返回异常。

503 供应商不可用或熔断打开。

Node.js

const response = await fetch("https://ailab.folhj.online/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.KAIMID_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "mimo-2.5-pro",
    messages: [{ role: "user", content: "你好" }]
  })
});

Python

import os, requests

resp = requests.post(
    "https://ailab.folhj.online/v1/chat/completions",
    headers={"Authorization": f"Bearer {os.environ['KAIMID_API_KEY']}"},
    json={"model": "mimo-2.5-pro", "messages": [{"role": "user", "content": "你好"}]},
)