> ## Documentation Index
> Fetch the complete documentation index at: https://docs.somark.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题（FAQ）

> 常见问题与使用说明

如在使用过程中遇到其他问题，或有新的功能需求，欢迎扫描下方二维码加入用户交流群，随时与我们沟通。你的反馈将成为我们产品更新的重要参考。

<img src="https://mintcdn.com/soulcode-aa7e5a93/I8QD66YzkFVIEkWW/images/%E5%B0%8F%E5%8A%A9%E6%89%8B%E4%BA%8C%E7%BB%B4%E7%A0%81.png?fit=max&auto=format&n=I8QD66YzkFVIEkWW&q=85&s=1f0b58c6d5a0575d98142217ed4cc30d" alt="SoMark 小助手二维码" style={{ width: "160px", height: "auto", display: "block", margin: "0 auto" }} width="300" height="300" data-path="images/小助手二维码.png" />

## 如何获取 API key？

A：请前往 [SoMark API 工作台](https://somark.tech/workbench/apikey) 获取 API Key。我们为每位用户提供免费解析额度：每日最多 `500` 页、每月最多 `2000` 页。超出免费额度后，系统会自动改为消耗付费用量。

## 为什么会出现 QPS 超限，应该怎么处理？

A：通常是因为上一个文件还在解析中，结果未返回就重复上传，单并发场景下会触发限流。正确做法是：同一文件只提交一次，后续只查询结果并等待。

## 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 能力融入日常办公与生活场景。