入门总览

开始使用 SoMark 前，请先明确你的场景需求。SoMark 提供多种接入方式来适应不同场景：直接调用 HTTP 接口、终端脚本、代码集成、Agent 平台工具、MCP 客户端等。

SoMark 有哪些接入方式

直接调 HTTP 接口。

适合终端、脚本和批处理。

适合接进代码和服务端。

适合 Agent 平台里的 Skill 接入。

适合 MCP 客户端里的助手调用。

SoMark 支持同步和异步两种解析模式。选择哪种取决于你的处理场景和文件大小。

场景	推荐方式	说明
需要立即得到结果，文件较小（< 30MB）	同步解析	一次请求直接返回解析结果，适合快速反馈场景。
处理较大文件或批量文档（> 30MB）	异步解析	先提交任务，后查询结果，适合长时间处理。