API 接入
min-agent serve 启动本地 HTTP 服务，以编程方式调用代理能力。未配置服务商时使用内置 OpenRouter 模型，不必先运行 min-agent setup。
bash
min-agent serve
min-agent serve --host 0.0.0.0 --port 3000环境变量
| 环境变量 | 说明 |
|---|---|
MIN_AGENT_SERVE_HOST | 监听地址（默认 127.0.0.1） |
MIN_AGENT_SERVE_PORT | 端口（默认 8787） |
MIN_AGENT_SERVE_TOKEN | Bearer token 鉴权 |
MIN_AGENT_SERVE_CORS | 设为 1 启用 CORS |
常用端点
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /health | 存活检查 |
| GET | /v1/models | 模型列表 |
| POST | /v1/chat | 对话（项目感知） |
| GET | /v1/sessions | 列出会话 |
| GET | /v1/diff | 工作区未提交变更 |
完整端点与请求/响应格式见完整 API 文档。
安全说明
- 监听地址不是 loopback 时必须设置
MIN_AGENT_SERVE_TOKEN，否则服务拒绝启动 /v1/chat等接口最多支持 8 个并发请求，超出返回429- 会话 ID 仅接受
[A-Za-z0-9_-]+，防止路径穿越