file-md-json API
把 PDF、DOCX、XLSX、CSV 文件解析为 Markdown 文本和结构化 md-json。上传文件、提交解析任务、按 task_id 取结果，单文件最大 10 MB。
- 工具 ID
file-md-json- 支持格式
PDF / DOCX / XLSX / CSV- 文件上限
10 MB- 价格
$0.001 / 次- 目录核验
file-md-json 是什么？
file-md-json 是 Roko 工具服务中的文档解析工具：上传 PDF、Word（DOCX）、Excel（XLSX）或 CSV 文件，返回 Markdown 文本与结构化 md-json 结果（schema_version 1.0），供下游检索、摘要或大模型流水线直接消费。
解析由 Cloudflare Markdown Conversion 通道执行，适合合同、报告、说明书等文档的批量结构化。上传响应返回 id；调用 invoke 时把它作为 input.file_id，接口再返回 task_id 供查询结果。
工具按调用次数计费，每解析一个文件 $0.001，失败任务不计费。调用需要 Roko API Key，并在令牌上开启对应工具的调用权限。
核心能力
四种文档格式
PDF、DOCX、XLSX、CSV 均可解析，覆盖常见办公与数据文件。
双格式输出
一次解析同时返回 Markdown 文本与 md-json 结构，options 里按需选择。
异步任务与幂等
invoke 支持唯一 Idempotency-Key，重放不重复计费；结果按 task_id 查询。
按次计费
每文件 $0.001，无最低消费；解析失败不计费。
支持的输入格式
以下扩展名来自当前工具服务的执行器定义；单文件大小上限 10 MB，每次上传一个文件。
| 格式 | 说明 | 限制 |
|---|---|---|
| PDF 文档 | 按页解析为 Markdown；扫描件不支持 OCR | |
| DOCX | Word 文档（Office Open XML） | 旧版 .doc 不支持，请先另存为 .docx |
| XLSX | Excel 工作簿 | 表格转 Markdown 表格 |
| CSV | 逗号分隔数据 | 转 Markdown 表格；也走本地文本工具 |
file-md-json 价格
当前价格核验自 2026-10-06 Roko 生产工具目录快照，按成功调用次数计费；实际费用以调用时的结算记录为准。
| 计费项 | 价格 |
|---|---|
| 每次解析调用 | $0.001 |
费用怎么算？
单份合同或报告的常规成本。
批量归档与检索场景的典型开销；失败任务不计费。
三步调用 file-md-json
上传响应返回 id；将它填入 invoke 请求的 input.file_id，提交解析任务后再按 task_id 获取结果。不要在前端代码中暴露 API Key。
1. 上传文件
curl https://api.rokoapi.com/v1/tools/file-md-json/files \
-H "Authorization: Bearer $API_KEY" \
-F "file=@/path/to/report.pdf"2. 提交解析任务
curl https://api.rokoapi.com/v1/tools/file-md-json/invoke \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: parse-report-0001" \
-d '{
"input": { "file_id": "FILE_ID" },
"options": { "output_formats": ["markdown", "json"] }
}'3. 查询解析结果
curl https://api.rokoapi.com/v1/tasks/$TASK_ID/result \
-H "Authorization: Bearer $API_KEY"invoke 返回 202 与 task_id，解析完成后通过结果接口读取 md-json（schema_version 1.0）。Idempotency-Key 需为 8–64 位字母、数字、下划线或连字符；相同 Key 的重放会返回原任务而不重复计费。
使用前要知道的限制
- 单文件最大 10 MB，每次上传一个文件。
- 扫描版 PDF 没有 OCR 能力，解析结果会缺失文字内容。
- 旧版 .doc、.xls 等二进制旧格式不支持，请先转换为 DOCX/XLSX。
- 任务结果有保存时限，请及时拉取并转存；不要把 API Key 暴露在前端。
- 解析质量取决于文档结构；复杂版式、公式与嵌套表格可能出现细节偏差。
file-md-json 常见问题
file-md-json 支持哪些文件格式？
当前支持 PDF、DOCX、XLSX、CSV 四种格式，单文件不超过 10 MB。
file-md-json 怎么收费？
2026-10-06 生产目录价格为每次 $0.001。解析失败的任务不计费，实际价格以调用时的结算记录为准。
md-json 输出包含哪些字段？
结果 JSON 包含 schema_version、markdown（Markdown 全文）、structure_source、capabilities（OCR、页引用、边界框、结构化表格等能力标记）与 warnings 数组。
和 text-md-json 有什么区别？
text-md-json 处理纯文本与代码类文件（txt/md/csv/代码等），按本地逻辑转换，价格更低（$0.0001/次）；file-md-json 处理 PDF/DOCX/XLSX 等二进制文档，走文档转换通道，$0.001/次。
可以批量解析吗？
可以。每次调用解析一个文件，批量场景在客户端循环上传并提交，每个任务用不同的 Idempotency-Key。
为什么调用返回 403 或权限错误？
工具调用需要 API Key 且令牌需开启对应工具的调用权限。请在控制台为令牌勾选 file-md-json 工具后重试。