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。
快速开始
- 在首页创建 Key 并复制,它以 sk_maicode2_ 开头。
- 一次性支付 $5 起充值余额。
- 使用 Base URL 和你的 Key 发送请求。
https://maicode2.com/v1curl 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。
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 https://maicode2.com/v1/models -H "Authorization: Bearer $MAICODE2_API_KEY"GET /v1/balance
返回该 Key 所属账户的剩余美元余额。
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 会抛出常规异常。
{
"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"
}
}我们不保存请求和回复内容,只保留计量数据:模型、token 数、费用、状态和时间。