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