MCode

API 文档

MAI Code 2 API 文档

MAI Code 2 API 采用 OpenAI Chat Completions 格式。把 OpenAI 客户端指向下面的 Base URL,用你的 Key 作为 Bearer Token,并选择 mai-code-2 或 mai-code-2-flash。

快速开始

  1. 在首页创建 Key 并复制,它以 sk_maicode2_ 开头。
  2. 一次性支付 $5 起充值余额。
  3. 使用 Base URL 和你的 Key 发送请求。
Base URL
https://maicode2.com/v1
cURL
curl https://maicode2.com/v1/chat/completions \
  -H "Authorization: Bearer $MAICODE2_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mai-code-2",
    "messages": [{"role": "user", "content": "Write a Python function that checks if a string is a palindrome."}]
  }'

在编辑器和智能体中使用 MAI Code 2

任何支持添加 OpenAI 兼容服务商的工具都能使用。填写 Base URL、粘贴 Key,再输入模型 ID 即可。常见搭配是:聊天和智能体任务用 MAI Code 2,自动补全或辅助模型用 MAI Code 2 Flash。

Cline / Roo Code / Kilo Code
API Provider:  OpenAI Compatible
Base URL:      https://maicode2.com/v1
API Key:       sk_maicode2_your_key
Model ID:      mai-code-2

在 VS Code 中打开扩展设置,选择 OpenAI Compatible 服务商。

接口参考

POST /v1/chat/completions

生成一条回复。支持的字段:model、messages、max_tokens 或 max_completion_tokens、temperature、top_p、stop、stream、stream_options、tools、tool_choice、parallel_tool_calls、response_format、seed、presence_penalty、frequency_penalty 和 reasoning_effort。其他字段会被忽略;n 必须为 1。

设置 stream: true 时,回复以 Server-Sent Events 返回,并以 data: [DONE] 结束。设置 stream_options.include_usage 可在最后收到包含 token 数量的数据块。

工具调用请求体
{
  "model": "mai-code-2",
  "messages": [{"role": "user", "content": "What is in src/app.ts?"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "read_file",
      "description": "Read a file from the repository",
      "parameters": {"type": "object", "properties": {"path": {"type": "string"}}, "required": ["path"]}
    }
  }]
}

GET /v1/models

列出当前可用的模型。

cURL
curl https://maicode2.com/v1/models -H "Authorization: Bearer $MAICODE2_API_KEY"

GET /v1/balance

返回该 Key 所属账户的剩余美元余额。

cURL
curl https://maicode2.com/v1/balance -H "Authorization: Bearer $MAICODE2_API_KEY"

计费

每个请求按实际使用的 token 从美元余额中扣费,最低 $0.001。请求开始前,会按输入估算加 max_tokens 的费用预留余额;请求结束后按实际用量扣费,剩余部分立即退回。如果余额不足以覆盖 max_tokens,请求会以较小的 max_tokens 运行;低于 256 token 时返回 402 拒绝。失败的请求不收费。

每个响应都带有 X-Request-Id 响应头。非流式响应还会带有 X-Balance-Charged-Usd,显示最终扣费金额。

查看价格与充值 →

错误与限制

错误采用 OpenAI 错误格式,SDK 会抛出常规异常。

400请求无效:模型未知、messages 格式错误或超出输入上限。
401API Key 缺失、格式错误、不存在或已撤销。
402余额不足以支付此请求。请充值后重试。
429达到频率或并发限制。请按 Retry-After 响应头等待后重试。
502模型服务商返回错误,预留的余额已退回。
503模型暂时不可用,不会扣费。
错误响应体
{
  "error": {
    "message": "Insufficient balance: this request needs at least $0.004. Add balance at https://maicode2.com/pricing.",
    "type": "insufficient_quota",
    "param": null,
    "code": "insufficient_quota"
  }
}
单次请求输入上限262,144 token
默认 max_tokens8,192 token
max_tokens 上限32,768 token
每个 Key 每分钟请求数120
每个账户的并发请求数8

我们不保存请求和回复内容,只保留计量数据:模型、token 数、费用、状态和时间。