file-md-json API
Phân tích tệp PDF, DOCX, XLSX và CSV thành văn bản Markdown và md-json có cấu trúc. Tải tệp lên, gửi tác vụ phân tích, lấy kết quả theo task_id — tối đa 10 MB mỗi tệp.
- ID công cụ
file-md-json- Định dạng
PDF / DOCX / XLSX / CSV- Giới hạn tệp
10 MB- Giá
$0.001 / lần- Đã xác minh danh mục
file-md-json là gì?
file-md-json là công cụ phân tích tài liệu trong dịch vụ công cụ của Roko: tải lên tệp PDF, Word (DOCX), Excel (XLSX) hoặc CSV và nhận lại văn bản Markdown cùng kết quả md-json có cấu trúc (schema_version 1.0), sẵn sàng cho tìm kiếm, tóm tắt hoặc pipeline LLM.
Việc phân tích chạy qua kênh Cloudflare Markdown Conversion, phù hợp cấu trúc hóa hợp đồng, báo cáo và tài liệu hướng dẫn. Phản hồi tải tệp trả về id; truyền nó vào input.file_id của invoke để nhận task_id dùng truy vấn kết quả.
Công cụ tính phí theo lần gọi, $0.001 mỗi tệp phân tích; tác vụ thất bại không bị tính phí. Gọi công cụ cần API key của Roko với quyền gọi công cụ được bật trên token.
Năng lực chính
Bốn định dạng tài liệu
PDF, DOCX, XLSX và CSV đều phân tích được, phủ các tệp văn phòng và dữ liệu phổ biến.
Đầu ra kép
Một lần phân tích trả về cả văn bản Markdown và cấu trúc md-json; chọn định dạng trong options.
Tác vụ bất đồng bộ và idempotent
invoke nhận Idempotency-Key duy nhất; gọi lại không bị tính phí hai lần. Kết quả truy vấn theo task_id.
Tính phí theo lần
$0.001 mỗi tệp, không mức tối thiểu; phân tích thất bại không tính phí.
Định dạng đầ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.
| Định dạng | Ghi chú | Giới hạn |
|---|---|---|
| Tài liệu PDF | Phân tích theo trang thành Markdown; PDF scan không có OCR | |
| DOCX | Tài liệu Word (Office Open XML) | .doc cũ không hỗ trợ — hãy lưu lại thành .docx |
| XLSX | Sổ tính Excel | Bảng chuyển thành bảng Markdown |
| CSV | Dữ liệu phân tách bằng dấu phẩy | Chuyển thành bảng Markdown; công cụ local-text cũng xử lý được |
Giá file-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.001 |
Ví dụ tính chi phí
Chi phí thông thường cho một hợp đồng hoặc báo cáo.
Mức chi tiêu điển hình cho lưu trữ và tìm kiếm; tác vụ thất bại không tính phí.
Gọi file-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/file-md-json/files \
-H "Authorization: Bearer $API_KEY" \
-F "file=@/path/to/report.pdf"2. Gửi tác vụ phân tích
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. 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 đúng một tệp.
- PDF scan không có OCR — nội dung chữ sẽ thiếu trong kết quả phân tích.
- Định dạng nhị phân cũ như .doc, .xls không hỗ trợ; hãy chuyển sang DOCX/XLSX trước.
- 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.
- Chất lượng phân tích phụ thuộc cấu trúc tài liệu; bố cục phức tạp, công thức và bảng lồng nhau có thể sai lệch chi tiết.
Câu hỏi thường gặp về file-md-json
file-md-json hỗ trợ những định dạng tệp nào?
Hiện tại là PDF, DOCX, XLSX và CSV, tối đa 10 MB mỗi tệp.
file-md-json giá bao nhiêu?
Danh mục production ngày 06-10-2026 ghi $0.001 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, capabilities (các cờ OCR, tham chiếu trang, khung bao, bảng có cấu trúc) và mảng warnings.
Khác thế nào với text-md-json?
text-md-json xử lý tệp văn bản thô và mã nguồn (txt/md/csv/code) bằng chuyển đổi cục bộ, rẻ hơn ($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.
Có phân tích hàng loạt được không?
Có. Mỗi lần gọi phân tích một tệp; với nhu cầu hàng loạt hãy lặp tải lên và gửi tác vụ phía client, dùng Idempotency-Key khác nhau cho mỗi tác vụ.
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 file-md-json cho token của bạn trong console rồi thử lại.