调用文档

本站提供 OpenAI 兼容接口。把 SDK / Cursor / Cherry Studio / OpenClaw 的地址改到这里，用控制台签发的令牌调用。

调用地址

请求头必须带：Authorization: Bearer sk-你的令牌。不要再在 Base URL 后面多加一层 /v1（填好上面这一条即可）。

控制台：https://api.mkcmd.com（登录、建令牌、看额度）。文档：https://api.mkcmd.com/docs。

如何获取可用模型

以令牌请求 GET /v1/models，返回 OpenAI 格式的列表。其中 id 就是调用名（档位名），例如 deepseek-flash、glm-flash。请按这个名字配置客户端，不要填厂商带版本号的 ID（如 :0731、v4.1）。上游换版本由本站后台改映射，你这边不用改配置。

curl https://api.mkcmd.com/v1/models \
  -H "Authorization: Bearer sk-你的令牌"

只抽出模型 ID：

curl -sS https://api.mkcmd.com/v1/models \
  -H "Authorization: Bearer sk-你的令牌" \
  | python3 -c "import json,sys; [print(x['id']) for x in json.load(sys.stdin).get('data') or []]"

成功时大意如下（字段以实际返回为准）：

{
  "object": "list",
  "data": [
    {"id": "glm-flash", "object": "model", "owned_by": "..."},
    {"id": "deepseek-flash", "object": "model"}
  ]
}

调用示例

curl

curl https://api.mkcmd.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-flash",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

Python（openai 库）

from openai import OpenAI

client = OpenAI(
    base_url="https://api.mkcmd.com/v1",
    api_key="sk-你的令牌",
)

resp = client.chat.completions.create(
    model="glm-flash",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Cursor / Cherry Studio 等

选 OpenAI 兼容协议：

• Base URL：https://api.mkcmd.com/v1
• API Key：控制台令牌
• Model：GET /v1/models 返回的 id

流式输出

请求里加 "stream": true，响应为 SSE。部分思考型模型（如 GLM、gpt-oss）会把推理过程放在 reasoning 字段，正文可能稍后才出现，请把 max_tokens 设大一些。

OpenClaw 自定义提供商

深圳本机 OpenClaw 里选「自定义提供商」时，界面字段比内置 Ollama 多。Ollama 插件会自己发现模型；自定义 OpenAI 兼容提供商默认不会自动拉全量模型，要先用上面的 GET /v1/models 拿到 ID，再逐条「添加模型」。

需要用的模型都要点「添加模型」各加一行。只加提供商、不填模型，OpenClaw 里选不到本站模型。

若改配置文件 openclaw.json（字段比 GUI 多，GUI 没有的可写在这里）：

{
  "models": {
    "providers": {
      "mkcmd": {
        "baseUrl": "https://api.mkcmd.com/v1",
        "apiKey": "sk-你的令牌",
        "api": "openai-completions",
        "timeoutSeconds": 300,
        "models": [
          {"id": "glm-flash", "name": "GLM Flash", "reasoning": true, "input": ["text", "image"], "contextWindow": 1048576, "maxTokens": 32768},
          {"id": "deepseek-flash", "name": "DeepSeek Flash", "reasoning": true, "input": ["text"], "contextWindow": 1048576, "maxTokens": 32768},
          {"id": "minimax", "name": "MiniMax", "reasoning": true, "input": ["text", "image"], "contextWindow": 512000, "maxTokens": 32768},
          {"id": "mistral", "name": "Mistral", "reasoning": false, "input": ["text", "image"], "contextWindow": 262144, "maxTokens": 8192}
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "mkcmd/glm-flash" }
    }
  }
}

配置文件里请带上 contextWindow、reasoning、input（有视觉则含 image）、maxTokens。GUI 只填 ID 时，OpenClaw 不会像内置 Ollama 那样去拉 /api/show，上下文会落到默认约 200K，推理开关也可能是关的。完整列表：https://api.mkcmd.com/ops/api/openclaw-models（把数组贴进 models.providers.mkcmd.models）。

错误码

失败时 HTTP 状态码 + JSON：{"error":{"type":"new_api_error","code":"...","message":"..."}}。message 末尾带 request id，报障时请一并提供。

可用模型

客户端只填调用名。上下文 / 推理 / 视觉 / 「当前实际」随后台映射更新：改替换模型后在探测页点「刷新能力」，本表和 GET /v1/models 的 description 会换成新上游（如 V4 Flash → V4.1 Flash）。自定义提供商仍需把 openclaw-models 再贴进配置（或重启后重拉）。

计费

按 token 计费。下表为本站结算价，单位：美元 / 百万 token。实际扣费以控制台「日志 / 钱包」为准。

说明

• 调用名必须与 /v1/models 完全一致。用 deepseek-flash 这种档位名，不要填上游版本号。
• 响应 JSON 里的 model 有时会带回上游自己的版本号，忽略即可；客户端配置始终用本站调用名。
• 公开注册已关闭，账号由管理员发放；每人可在控制台自行创建多个令牌并限制模型或额度。
• OpenClaw 自定义提供商不会自动发现本站模型，见上文 OpenClaw。
• 完整管理功能（渠道、用户、充值）见控制台，不在本文档范围。