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 工具後重試。