OpenAPI 3.0 / Swagger UI

MuguaApi

面向第三方客户的标准在线接口文档。下方 Swagger UI 可直接查看字段定义、枚举值、请求示例、错误码及在线调试；原始规范文件也可以直接导入 Postman、Insomnia 或客户自己的 API 平台。

Base URL

http://api.test.mugua.muguafabao.com

OpenAPI JSON

http://api.test.mugua.muguafabao.com/openapi.json

Auth Header

Authorization: Bearer sk-xxxx

接入说明

业务接口只有两个：POST /v1/legal-chat/completions 和 POST /v1/case-analysis/generate。上传文件时请使用 multipart/form-data，文件字段名必须是 files[]，支持 TXT/PDF/DOC/DOCX。如需解析 DOC，服务端需安装 antiword、catdoc 或 LibreOffice(soffice)。

流式模式会返回 text/event-stream。客户端需要按 SSE 事件顺序读取 response.created、业务增量事件以及 response.completed。

标准错误码

HTTP	error.type	说明
`400`	`invalid_request_error`	请求参数不合法、字段缺失、文件格式或请求方式不符合要求。
`401`	`authentication_error`	未携带 Bearer Token、Token 格式错误或 API Key 无效。
`402`	`billing_error`	API Key 可用调用次数不足，无法继续扣费。
`429`	`rate_limit_error`	请求频率超过 API Key 当前限流阈值，响应头会返回退避信息。
`500`	`server_error`	服务内部异常，例如计费规则缺失或未配置可用模型通道。
`502`	`server_error`	模型网关返回空内容或所有上游模型通道调用失败。
`503`	`server_error`	限流依赖服务不可用，例如 Redis 认证失败或连接异常。