text-md-json API
把 txt、md、csv、json、yaml、代码文件等文本内容转为 Markdown 与结构化 md-json。本地逻辑处理，单文件最大 10 MB，每次调用 $0.0001。
- 工具 ID
text-md-json- 支持类型
txt / md / csv / 代码等 23 种扩展名- 文件上限
10 MB- 价格
$0.0001 / 次- 目录核验
text-md-json 是什么？
text-md-json 是 Roko 工具服务中的本地文本解析工具：上传 txt、md、csv、json、yaml、html 以及 go、py、js、ts 等代码文件，返回 Markdown 文本与结构化 md-json（schema_version 1.0）。
处理逻辑在服务端本地执行：md 与 txt 原样作为 Markdown 返回；代码、CSV、JSON 等按字面文本包进围栏代码块，不做标记解释。适合把异构文本资产统一成可检索、可喂给大模型的标准输入。
它是 Roko 价格最低的工具之一：每次调用 $0.0001，失败任务不计费。调用需要 Roko API Key，并在令牌上开启对应工具的调用权限。
核心能力
23 种文本扩展名
txt、md、csv、json、yaml、html 与 go、py、js、ts 等源码文件均可解析。
保真转换
md/txt 原样输出；代码与数据文件以围栏代码块字面保留，不破坏内容。
双格式输出
同时返回 Markdown 文本与 md-json 结构，options 里按需选择。
极致单价
每次调用 $0.0001，适合高频、大批量的文本归一化场景。
支持的输入类型
以下扩展名来自当前工具服务的执行器定义；单文件大小上限 10 MB，每次上传一个文件。
| 类型 | 扩展名 | 处理方式 |
|---|---|---|
| 文本与标记 | txt、md | 原样作为 Markdown 输出 |
| 数据文件 | csv、json、yaml、yml、xml | 以围栏代码块字面保留 |
| 网页 | html | 以围栏代码块字面保留 |
| 源码 | go、py、js、ts、tsx、jsx、css、java、c、cpp、h、rs、sql、sh | 以围栏代码块字面保留 |
text-md-json 价格
当前价格核验自 2026-10-06 Roko 生产工具目录快照，按成功调用次数计费；实际费用以调用时的结算记录为准。
| 计费项 | 价格 |
|---|---|
| 每次解析调用 | $0.0001 |
费用怎么算？
单文件的常规成本，几乎可以忽略。
整库文本归一化的典型开销；失败任务不计费。
三步调用 text-md-json
上传响应返回 id；将它填入 invoke 请求的 input.file_id，提交解析任务后再按 task_id 获取结果。不要在前端代码中暴露 API Key。
1. 上传文件
curl https://api.rokoapi.com/v1/tools/text-md-json/files \
-H "Authorization: Bearer $API_KEY" \
-F "file=@/path/to/notes.md"2. 提交解析任务
curl https://api.rokoapi.com/v1/tools/text-md-json/invoke \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: text-parse-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 等）不在本工具范围内，请使用 file-md-json。
- 任务结果有保存时限，请及时拉取并转存；不要把 API Key 暴露在前端。
- md 与 txt 原样返回，工具不会校验或修补内容格式本身。
text-md-json 常见问题
text-md-json 支持哪些文件类型？
23 种文本扩展名：txt、md、csv、json、yaml、yml、xml、html，以及 go、py、js、ts、tsx、jsx、css、java、c、cpp、h、rs、sql、sh 等源码文件。
text-md-json 怎么收费？
2026-10-06 生产目录价格为每次 $0.0001。解析失败的任务不计费，实际价格以调用时的结算记录为准。
md-json 输出包含哪些字段？
结果 JSON 包含 schema_version、markdown（Markdown 全文）、structure_source、capabilities 能力标记与 warnings 数组，与 file-md-json 同一结构。
和 file-md-json 有什么区别？
text-md-json 面向文本与代码类文件，本地逻辑转换，$0.0001/次；file-md-json 面向 PDF/DOCX/XLSX 等二进制文档，走文档转换通道，$0.001/次。
代码文件会被改写吗？
不会。代码、CSV、JSON 等以围栏代码块字面保留，内容不做改写、解释或格式重排。
为什么调用返回 403 或权限错误？
工具调用需要 API Key 且令牌需开启对应工具的调用权限。请在控制台为令牌勾选 text-md-json 工具后重试。