Parser管理对象与调用规则

调用前准备

BASE_URL、MOI_KEY与WORKSPACE_ID来自同一环境。BACKEND_ID/ENDPOINT_ID由同环境Parser读取或创建取得。示例地址和key-example-*都是占位值,生产支持及真实服务需另行确认。

/parser管理入口使用普通产品身份,按X-Workspace-ID选租户。后端kind为parser,规范ID为正十进制;不能把LLM或Embedding的同值整数当作同一对象。集合/详情/端点读取要求model_backend.read,创建要求工作区model_backend.create,更新/端点写入要求对象update,删除要求delete;Router分别要求工作区model_router.read/update。

原始文件解析与转换不在这十个产品管理动作中,见相关接口。普通PAT、系统密钥与已验证Worker执行身份不能相互替代。

HTTP与客户端返回

动作

HTTP data

SDK/CLI适配

后端列表

数组,空可null

backends集合。

端点列表

数组,空可null

endpoints集合。

创建/详情/更新

后端对象

ProviderBackend;不是模型配置对象。

创建端点

端点对象

ProviderEndpoint。

删除/设置端点状态

null

客户端可合成success:true,非服务端额外字段。

Router读取/写入

配置对象

ProviderRouterConfig。

十动作均HTTP200、code=”OK”、msg=”OK”;没有LLM工作区式201/204,也没有total/对外分页。

后端字段

类型

说明

id

integer

Parser后端ID。

name

string

名称。

type

string

PARSER_*协议类型。

timeout_seconds

integer

超时秒数;创建默认3600,配置上限86400。

supported_mime_types

array(字符串数组)或null

MIME声明,空为catch-all;不测试实际解析能力。

endpoints

array(对象数组)

非空读取可带在线端点,空时省略;普通创建/更新不补端点。

created_at

integer

Unix秒。

updated_at

integer

Unix秒。

返回对象没有api_key、api_keys_encrypted或models。便捷SDK复用ProviderBackend,出现这些属性的默认空值不代表HTTP返回了字段。

Parser类型包括PARSER_MINERU、PARSER_UNOSERVER、PARSER_OPENXML、PARSER_PADDLEOCR、PARSER_DEV、PARSER_WPS_CONVERTER、PARSER_LIBREOFFICE、PARSER_MOI_AUDIO_SERVICE。创建的非Parser值回退MINERU,不能据保存成功证明适配器/部署支持。普通解析选择器排除WPS_CONVERTER/LIBREOFFICE,两者属于转换路径;DEV也不作为生产能力承诺。

端点字段

类型

说明

id

integer

端点ID;离线前保留。

backend_id

integer

所属Parser后端。

address

string

接入地址。

status

string

ONLINE/OFFLINE。设置输入先trim+大写,非法按ONLINE。

created_at

integer

Unix秒。

updated_at

integer

Unix秒。

Parser集合JOIN、后端详情和端点读取均过滤离线。DAO内部按ID批量读取,不表示公开支持cursor/page。状态保存不测健康;无独立端点删除动作,离线不等于删除。

密钥池与更新

创建/更新的api_keys_encrypted是有序池;每项必须去空白后非空,规范化时trim但不自行去重。非空池优先于同请求api_key,保存的单密钥镜像池首项。名称和单密钥的空值、超时非正值均不表达清除;MIME只有非空数组更新,[]保留旧声明。

更新池省略/null保留,非空数组完整替换;[]退回单密钥模式。未同时提供非空api_key时保留原单密钥/首项,不是清除全部凭据。DAO会把单密钥规范化成一项池,不能用JSON数组必须为空判断模式转换。已有池多于一项而只传api_key会返回400/ErrParamInvalid;完整替换应保留调用者自己的全部池配置,响应不回传池。

Router与运行效果

字段

类型

写入默认

strategy

string

非法或省略按ROUND_ROBIN;接受LEAST_CONNECTIONS/MODEL_BASED。

health_check_interval

integer

非正/省略按30秒。

max_retries

integer

非正/省略按0。

session_affinity

boolean

省略/null按false。

GET缺配置时owner临时默认为ROUND_ROBIN/30/2/false,不能据此证明已持久化。PUT按请求加默认值完整写入,DAO更新已有行;

所选Parser选择器按精确MIME、catch-all、租户/系统候选和在线端点轮换,未读取strategy字段。声明MIME可含精确类型或*/*,空声明为catch-all;系统显式MIME可在特定租户catch-all场景优先。

错误与结果确认

错误使用string code/msg。输入、超时上限、错误类型/ID及单密钥覆盖多池可为400/ErrParamInvalid,对象缺失可为404,当前角色拒绝403,依赖故障503,其余按各入口映射。绑定未启用统一严格拒绝未知键;额外字段不能据成功当作已写入。

配置、路由解析、文件执行和实际结果分别确认;

最后更新于