如何获取 API key？
A：请前往 SoMark API 工作台 获取 API Key。我们为每位用户提供免费解析额度：每日最多500 页、每月最多 2000 页。超出免费额度后，系统会自动改为消耗付费用量。
为什么会出现 QPS 超限，应该怎么处理？
A：每个账号的调用频率上限为 QPS 4，短时间内超过该频率会触发限流。请控制请求频率；同一文件只提交一次，后续查询结果即可。SoMark 支持哪些文件格式？
A：SoMark 目前支持以下文件格式：pdf、png、jpg、jpeg、bmp、tiff、jp2、dib、ppm、pgm、pbm、gif、heic、heif、webp、xpm、tga、dds、xbm、doc、docx、ppt、pptx、xlsx、xlsm、xls。
解析后的结果格式是什么？
A：SoMark 默认返回 Markdown 格式文本，同时支持返回 JSON 格式的结构化数据，包含文档元素、坐标信息等详细内容。在 Coze/dify 中使用 SoMark 插件可以做什么？
A：-
文档对话 Bot
结合 SoMark，用户可在 Coze 聊天窗口直接上传 PDF、图片等文件，提问“这份合同的核心条款是什么”或“总结这份年报”，Bot 会实时解析文档并给出回答，实现“边传边问”。 -
信息提取工作流
搭建自动化流程：用户上传发票、身份证、合同等文件后，SoMark 可解析并提取金额、号码、有效期等关键字段，再自动录入表格或触发后续通知、审批，无需人工录入。 -
多模态内容处理 Bot
处理含图文混排、表格、公式的复杂文档，例如学术论文、技术手册。Bot 可理解标题层级、表格数据和公式含义，支持专业领域问答与内容梳理。 -
知识库批量构建助手
将大量非结构化文档（Word、PDF、扫描件）批量导入，SoMark 解析为结构化数据后写入 Coze 知识库，快速搭建企业知识问答 Bot，方便员工直接查询内部资料。 -
跨平台文档助手
将 Bot 发布到微信、飞书等即时通讯工具后，用户可在聊天中发送文档并获取摘要、翻译、关键信息提取等服务，让 AI 能力融入日常办公与生活场景。
已经解析完成的 Markdown 如何将图片保存到本地？
A：如果 Markdown 中仍是远程图片 URL，可以使用文档插图本地存储 Skill下载图片并改写链接。需要集成到自己的程序时，再使用 Python 示例或完整 Skill 脚本。文档插图本地存储 Skill 会修改原始 Markdown 吗？
A：不会。Skill 会在输出目录中写入新的main.md 和 images/，原始 Markdown 保持不变。
文档插图本地存储 Skill 会自动生成 ZIP 吗？
A：不会。Skill 默认生成目录包。需要 ZIP 时，请在验证输出后单独压缩目录。为什么本地存储后的图片统一为 JPEG 格式？
A：统一重新编码可以验证下载内容确实是可解码图片，并得到稳定的文件扩展名。带透明通道的图片会使用白色背景。文档插图本地存储过程中部分图片下载失败会怎样？
A：单文件模式只有在全部图片成功后才写出新的main.md。批量模式会记录失败文档、继续处理其他文档，并以非零退出码结束。
文档插图本地存储支持批量处理多个 Markdown 文件吗？
A：可以。向完整 Skill 脚本传入目录，它会递归处理.md 和 .markdown 文件，并为每份文档创建独立输出包。页面中的精简 Python 示例只处理单个文件。