Transformers 支持 MiniCPM-OCR 了，为啥你的 API 还不一定能调？

10 月 26 日，Transformers v5.21 的发布说明把 MiniCPM-OCR 列进了新增模型支持。想拿它识别票据、截图，结果在自己用的 API 平台里搜不到？这并不矛盾：开源框架会加载一个模型，不等于 API 服务商已经部署它、开放了对应接口。

还有一个时间点得掰扯清楚：Hugging Face 的模型文档写明，MiniCPM-OCR 早在 2025 年已登载于 HF Papers；这次的新消息是它在 2026 年 10 月进入 Transformers。别把“框架新增支持”写成“模型刚发布”。

图：AI 生成的情境图。三道门分别比喻模型、框架和 API 服务，不是平台实际界面。

三道门，少开一道都不能直接用

第一道：模型有没有发布？ MiniCPM-OCR 的公开文档给出模型名称 openbmb/MiniCPM-OCR-1.0，以及用 Transformers pipeline("image-text-to-text") 处理图像和文字的示例。这回答的是“能否按文档在合适环境里加载”，不是“任何在线 API 都能调用”。

第二道：你的运行环境支不支持？ Transformers v5.21 增加支持，只说明这个库的相应版本具备实现。自己部署时还要看依赖、模型权重、硬件和实际推理结果；其他推理框架是否支持，要分别查它们的版本说明。只瞅见一个 GitHub Release 就开香槟，容易把杯子举到半空。

第三道：API 服务真的开了吗？ 去你使用的服务商模型列表或价格页核对：是否有这个准确模型 ID、你所在分组能否使用、是否支持图片输入、走哪个端点、如何计费。模型列表能查到，也只能算第一步；还得按该服务文档发一张不含隐私的测试图片，确认拿到可用结果，并核对用量记录。不要把本地 pipeline 示例直接当作云端 HTTP 请求格式。

图：每一层回答不同的问题；上一层成立，不自动证明下一层成立。

接入前，按这个顺序查

1. 查模型原始文档，确认模型名、输入类型和示例所用的框架版本。
2. 查目标 API 的模型列表、分组权限、端点和价格。找不到准确模型名，就先别在业务代码里写死它。
3. 用脱敏样本做一次最小请求，检查实际返回、错误正文和使用日志。识别票据时别上传真实客户票据做试验。

星桥 API 网关由我们运营。若你通过星桥接入模型，可在公众号菜单「模型价格」核对当前模型、分组和端点，再按「接入文档」做小请求；本文没有声称星桥已提供 MiniCPM-OCR。用别家的平台也照这三步查，省得把“代码支持”误认成“今天就能在线点单”。

资料：Hugging Face Transformers v5.21 发布说明与 MiniCPM-OCR 模型文档；星桥 API 使用文档。核对日期：2026-10-28。