file-md-json API
Разбирайте файлы PDF, DOCX, XLSX и CSV в текст Markdown и структурированный md-json. Загрузите файл, отправьте задачу разбора, получите результат по task_id — до 10 МБ на файл.
- ID инструмента
file-md-json- Форматы
PDF / DOCX / XLSX / CSV- Лимит файла
10 МБ- Тариф
$0.001 / вызов- Каталог проверен
Что такое file-md-json?
file-md-json — инструмент разбора документов в сервисах инструментов Roko: загрузите файл PDF, Word (DOCX), Excel (XLSX) или CSV и получите текст Markdown плюс структурированный результат md-json (schema_version 1.0), готовый для поиска, суммаризации или LLM-пайплайнов.
Разбор выполняется через канал Cloudflare Markdown Conversion и подходит для пакетной структуризации договоров, отчётов и инструкций. Ответ загрузки возвращает id; передайте его как input.file_id в invoke, который вернёт task_id для получения результата.
Тарификация повызовная — $0.001 за разобранный файл; неудачные задачи не тарифицируются. Для вызовов нужен API-ключ Roko с включённым на токене правом вызова этого инструмента.
Ключевые возможности
Четыре формата документов
PDF, DOCX, XLSX и CSV разбираются, покрывая типовые офисные и данные-файлы.
Двойной формат вывода
Один разбор возвращает и текст Markdown, и структуру md-json; форматы выбираются в options.
Асинхронные задачи с идемпотентностью
invoke принимает уникальный Idempotency-Key; повторы не тарифицируются дважды. Результат запрашивается по task_id.
Повызовная тарификация
$0.001 за файл, без минимального платежа; неудачные разборы не тарифицируются.
Поддерживаемые форматы ввода
Расширения взяты из текущего определения исполнителя сервиса инструментов; до 10 МБ на файл, один файл за загрузку.
| Формат | Примечания | Ограничения |
|---|---|---|
| Документы PDF | Разбор постранично в Markdown; для сканов OCR нет | |
| DOCX | Документы Word (Office Open XML) | Старый .doc не поддерживается — пересохраните в .docx |
| XLSX | Книги Excel | Таблицы конвертируются в таблицы Markdown |
| CSV | Данные с разделителем-запятой | Конвертируется в таблицы Markdown; обрабатывает и local-text |
Цены на file-md-json
Цены сверены со снимком рабочего каталога инструментов Roko от 06.10.2026. Оплачиваются успешные вызовы; окончательной считается запись расчёта на момент вызова.
| Единица тарификации | Цена |
|---|---|
| За вызов разбора | $0.001 |
Примеры расчёта
Обычная стоимость для одного договора или отчёта.
Типичный расход для архивации и поиска; неудачные задачи не тарифицируются.
Вызов file-md-json в три шага
Ответ загрузки возвращает id. Передайте его как input.file_id в invoke, затем получите готовый результат по task_id. Не раскрывайте API-ключ в клиентском коде.
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 символа (буквы, цифры, подчёркивания, дефисы); повтор с тем же ключом возвращает исходную задачу без повторной тарификации.
Ограничения, которые важно знать
- До 10 МБ на файл, ровно один файл за загрузку.
- Для сканированных PDF OCR нет — текст в разборе будет отсутствовать.
- Старые бинарные форматы .doc и .xls не поддерживаются; сначала конвертируйте в DOCX/XLSX.
- Результаты задач хранятся ограниченное время — забирайте и сохраняйте сразу. Не раскрывайте API-ключ в клиентском коде.
- Качество разбора зависит от структуры документа; сложные вёрстки, формулы и вложенные таблицы могут передаваться с отклонениями.
FAQ по file-md-json
Какие форматы файлов поддерживает file-md-json?
Сейчас PDF, DOCX, XLSX и CSV, до 10 МБ на файл.
Сколько стоит file-md-json?
Тарификация повызовная — $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-ключ с включённым правом вызова инструмента. Включите file-md-json для токена в консоли и повторите.