Unified API¶
状态: Implemented 读者: API 使用者、服务端开发者、SDK 开发者 范围: MinerU v1 API 的资源模型、认证、上传、文件、任务、对话、用量和限流 非目标: 本地 CLI 参数说明;SDK 封装细节 来源: 由根目录旧 Unified API 底稿迁移整理而来;修订记录和历史接口对比未迁移
当前定位¶
Unified API 文档描述两类部署形态下的同一套 API:
mineru.net官方远程 API。- 本地启动的 Local Parse Server API。
两者的 endpoint、请求结构和主要响应结构尽量保持一致。新文档默认先描述 mineru.net 的完整行为,再在每个主题末尾说明本地 server 的简化或差异。
目录¶
- API 总览: 资源模型、端点地图、认证、通用约定。
- 响应与错误: 成功响应、错误 envelope、请求追踪。
- Health、Models 与 Tiers: 服务能力、模型列表、解析档位。
- Uploads 与 Files: 上传生命周期、文件对象、产物下载。
- Parse Jobs: 解析任务、轮询。 V1 便捷解析: 一次提交、内联结果、同步包装和 Router 调度。
- Chat 与 Responses: OpenAI-compatible 文档对话接口。
- Webhooks: 异步回调协议。
- Usage 与 Limits: access level、限流、用量查询。
- 端到端示例: 常见调用流程。
整理原则¶
- 不迁移底稿开头的历史变更说明。
- 不迁移底稿末尾面向历史接口的对比内容。
- 官方 API 是主线;本地 server 差异只在对应主题中补充。
- 可观察行为优先,内部实现细节留给架构或配置文档。
相关文档¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 mi/MinerU