MiMoCode2API

将小米 MiMoCode 内置的 MiMo Auto 模型转换为标准 OpenAI 兼容 API，可被 Cursor、Cline、Cherry Studio、OpenCode 等任意 OpenAI 兼容客户端直接使用。

快速开始

1. 安装依赖

pip install -e .

2. 启动服务

python main.py

或使用 uvicorn：

uvicorn mimocode2api.main:app --host 0.0.0.0 --port 8000

默认监听 http://127.0.0.1:8000。

3. 测试

# 健康检查
curl http://localhost:8000/health

# 列出模型
curl http://localhost:8000/v1/models

# 流式对话
curl -N http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"mimo-auto","messages":[{"role":"user","content":"你好"}],"stream":true}'

# 非流式对话
curl http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"mimo-auto","messages":[{"role":"user","content":"你好"}],"stream":false}'

4. 在 OpenAI 客户端中使用

from openai import OpenAI

client = OpenAI(
    base_url="http://127.0.0.1:8000/v1",
    api_key="dummy",
)

response = client.chat.completions.create(
    model="mimo-auto",
    messages=[{"role": "user", "content": "你好"}],
    stream=True,
)
for chunk in response:
    print(chunk.choices[0].delta.content or "", end="")

配置

所有配置通过 MIMOCODE2API_* 环境变量或 .env 文件读取。

变量	默认值	说明
MIMOCODE2API_BASE_URL	https://api.xiaomimimo.com	上游 API 地址
MIMOCODE2API_CLIENT_ID	自动计算	手动指定 client id（一般不需要）
MIMOCODE2API_CLIENT_ID_FILE	.client_id	client id 持久化文件
MIMOCODE2API_DEFAULT_MODEL	mimo-auto	默认模型
MIMOCODE2API_MODEL_MAP	{}	模型别名映射，例如 {"gpt-4o":"mimo-auto"}
MIMOCODE2API_LISTEN_HOST	0.0.0.0	监听地址
MIMOCODE2API_LISTEN_PORT	8000	监听端口
MIMOCODE2API_REQUEST_TIMEOUT	300	上游请求超时（秒）
MIMOCODE2API_LOG_LEVEL	info	日志级别
MIMOCODE2API_API_KEY	空	API 访问密钥，留空则不校验

复制 .env.example 开始：

cp .env.example .env

在 Cursor 中使用

1. 打开 Cursor Settings → Models
2. 添加 OpenAI API Key（随意填写，如 dummy）
3. 将 API Base URL 设置为 http://localhost:8000/v1
4. 选择模型 mimo-auto

模型映射

MIMOCODE2API_MODEL_MAP='{"gpt-4o":"mimo-auto","claude-sonnet":"mimo-auto"}'

项目结构

mimocode2api/
├── main.py                  # 直接启动入口
├── pyproject.toml
├── .env.example
└── src/mimocode2api/
    ├── __init__.py          # 版本
    ├── main.py              # FastAPI 应用与生命周期
    ├── config.py            # 配置与硬件指纹计算
    ├── auth.py              # JWT 自动获取、缓存、刷新
    ├── upstream.py          # 上游 HTTP 客户端
    ├── compat.py            # OpenAI 请求/响应兼容转换
    └── routes.py            # OpenAI 兼容路由

免责声明

本项目仅供学习研究，使用请遵守 MiMo 服务条款。代理逻辑基于对官方 CLI 网络协议的分析，不保证上游接口长期稳定。

License

MIT