text-md-json API
Chuyển txt, md, csv, json, yaml và tệp mã nguồn thành Markdown và md-json có cấu trúc. Xử lý bằng logic cục bộ, tối đa 10 MB mỗi tệp, $0.0001 mỗi lần gọi.
- ID công cụ
text-md-json- Kiểu hỗ trợ
txt / md / csv / mã nguồn — 23 phần mở rộng- Giới hạn tệp
10 MB- Giá
$0.0001 / lần- Đã xác minh danh mục
text-md-json là gì?
text-md-json là công cụ phân tích văn bản cục bộ trong dịch vụ công cụ của Roko: tải lên tệp txt, md, csv, json, yaml, html hoặc mã nguồn như go, py, js, ts và nhận lại văn bản Markdown cùng md-json có cấu trúc (schema_version 1.0).
Xử lý chạy cục bộ trên máy chủ: md và txt đi thẳng dưới dạng Markdown; mã nguồn, CSV và JSON được giữ nguyên theo nghĩa đen trong khối mã có hàng rào, không diễn giải đánh dấu. Hợp để chuẩn hóa các tài sản văn bản dị cấu trúc thành đầu vào chuẩn cho tìm kiếm và LLM.
Đây là một trong những công cụ rẻ nhất của Roko: $0.0001 mỗi lần gọi, tác vụ thất bại không tính phí. Gọi công cụ cần API key Roko với quyền gọi công cụ được bật trên token.
Năng lực chính
23 phần mở rộng văn bản
txt, md, csv, json, yaml, html và tệp mã nguồn go, py, js, ts đều phân tích được.
Chuyển đổi giữ nguyên bản
md/txt đi thẳng nguyên bản; tệp mã và dữ liệu được giữ nguyên theo nghĩa đen trong khối mã.
Đầu ra kép
Trả về cả văn bản Markdown và cấu trúc md-json; chọn định dạng trong options.
Đơn giá sàn
$0.0001 mỗi lần gọi, hợp cho chuẩn hóa văn bản tần suất cao, quy mô lớn.
Kiểu đầu vào hỗ trợ
Phần mở rộng lấy theo định nghĩa executor hiện tại của dịch vụ công cụ; tối đa 10 MB mỗi tệp, mỗi lần tải một tệp.
| Kiểu | Phần mở rộng | Cách xử lý |
|---|---|---|
| Văn bản & đánh dấu | txt, md | Đi thẳng dưới dạng Markdown |
| Tệp dữ liệu | csv, json, yaml, yml, xml | Giữ nguyên trong khối mã có hàng rào |
| Trang web | html | Giữ nguyên trong khối mã có hàng rào |
| Mã nguồn | go, py, js, ts, tsx, jsx, css, java, c, cpp, h, rs, sql, sh | Giữ nguyên trong khối mã có hàng rào |
Giá text-md-json
Giá đã được đối chiếu với ảnh chụp danh mục công cụ production Roko ngày 06-10-2026. Mỗi lần gọi thành công được tính phí; bản ghi thanh toán lúc gọi là chuẩn cuối cùng.
| Hạng mục tính phí | Giá |
|---|---|
| Mỗi lần gọi phân tích | $0.0001 |
Ví dụ tính chi phí
Chi phí thông thường mỗi tệp, gần như không đáng kể.
Mức chi tiêu điển hình cho chuẩn hóa toàn kho; tác vụ thất bại không tính phí.
Gọi text-md-json trong ba bước
Phản hồi tải tệp trả về id. Truyền giá trị đó vào input.file_id của invoke, rồi lấy kết quả hoàn tất theo task_id. Không để lộ API key trong code phía client.
1. Tải tệp lên
curl https://api.rokoapi.com/v1/tools/text-md-json/files \
-H "Authorization: Bearer $API_KEY" \
-F "file=@/path/to/notes.md"2. Gửi tác vụ phân tích
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. Lấy kết quả
curl https://api.rokoapi.com/v1/tasks/$TASK_ID/result \
-H "Authorization: Bearer $API_KEY"invoke trả về 202 kèm task_id; khi phân tích xong, đọc md-json (schema_version 1.0) từ endpoint kết quả. Idempotency-Key dài 8–64 ký tự (chữ cái, số, gạch dưới hoặc gạch ngang); gọi lại với cùng key sẽ trả tác vụ gốc và không tính phí lần hai.
Giới hạn cần biết trước khi dùng
- Tối đa 10 MB mỗi tệp, mỗi lần tải một tệp; phần mở rộng phải nằm trong danh sách hỗ trợ.
- Tệp mã và dữ liệu được giữ nguyên theo nghĩa đen — không sắp xếp lại hay làm sạch ngữ nghĩa.
- Tệp thuần nhị phân (ảnh, PDF) nằm ngoài phạm vi công cụ này; hãy dùng file-md-json.
- Kết quả tác vụ có thời gian lưu giữ — hãy lấy và lưu trữ sớm. Không để lộ API key phía client.
- md và txt trả về nguyên bản; công cụ không kiểm tra hay vá định dạng nội dung.
Câu hỏi thường gặp về text-md-json
text-md-json hỗ trợ những kiểu tệp nào?
23 phần mở rộng văn bản: txt, md, csv, json, yaml, yml, xml, html, cùng tệp mã nguồn go, py, js, ts, tsx, jsx, css, java, c, cpp, h, rs, sql và sh.
text-md-json giá bao nhiêu?
Danh mục production ngày 06-10-2026 ghi $0.0001 mỗi lần gọi. Phân tích thất bại không tính phí; bản ghi thanh toán lúc gọi là chuẩn cuối cùng.
Đầu ra md-json gồm những trường nào?
JSON kết quả gồm schema_version, markdown (toàn bộ văn bản Markdown), structure_source, các cờ capabilities và mảng warnings — cùng cấu trúc với file-md-json.
Khác thế nào với file-md-json?
text-md-json nhắm đến tệp văn bản và mã nguồn với chuyển đổi cục bộ, $0.0001/lần; file-md-json phân tích tài liệu nhị phân như PDF/DOCX/XLSX qua kênh chuyển đổi với $0.001/lần.
Tệp mã nguồn có bị ghi đè không?
Không. Mã nguồn, CSV và JSON được giữ nguyên trong khối mã có hàng rào — không ghi đè, diễn giải hay định dạng lại.
Vì sao trả về 403 hoặc lỗi quyền?
Gọi công cụ cần API key và token phải bật quyền gọi công cụ tương ứng. Hãy bật text-md-json cho token của bạn trong console rồi thử lại.