file-md-json API
Convertissez des fichiers PDF, DOCX, XLSX et CSV en texte Markdown et md-json structuré. Téléversez un fichier, soumettez une tâche d'analyse, récupérez le résultat par task_id — jusqu'à 10 Mo par fichier.
- ID d'outil
file-md-json- Formats pris en charge
PDF / DOCX / XLSX / CSV- Limite de fichier
10 Mo- Tarification
0,001 $ / appel- Catalogue vérifié
Qu'est-ce que file-md-json ?
file-md-json est un outil d'analyse de documents des services d'outils Roko : téléversez un fichier PDF, Word (DOCX), Excel (XLSX) ou CSV et recevez du texte Markdown plus un résultat md-json structuré (schema_version 1.0), prêt pour la recherche, le résumé ou les pipelines LLM.
L'analyse s'exécute via le canal Cloudflare Markdown Conversion, adapté aux contrats, rapports et manuels. Le téléversement renvoie id ; transmettez-le comme input.file_id à invoke, qui renvoie ensuite un task_id pour consulter le résultat.
L'outil est facturé à l'appel : 0,001 $ par fichier analysé ; les tâches échouées ne sont pas facturées. Les appels exigent une clé API Roko avec la permission d'invocation de l'outil activée sur le token.
Capacités principales
Quatre formats de documents
PDF, DOCX, XLSX et CSV s'analysent, couvrant les fichiers bureautiques et de données courants.
Sortie double format
Une seule analyse renvoie à la fois le texte Markdown et la structure md-json ; choisissez les formats dans options.
Tâches asynchrones et idempotence
invoke accepte un Idempotency-Key unique ; les rejeux ne facturent jamais deux fois. Les résultats se consultent par task_id.
Facturation à l'appel
0,001 $ par fichier, sans minimum ; les analyses échouées ne sont pas facturées.
Formats d'entrée pris en charge
Les extensions proviennent de la définition d'exécuteur actuelle du service d'outils ; 10 Mo max par fichier, un seul fichier par téléversement.
| Format | Notes | Limites |
|---|---|---|
| Documents PDF | Analysé page par page en Markdown ; pas d'OCR pour les PDF scannés | |
| DOCX | Documents Word (Office Open XML) | L'ancien .doc n'est pas pris en charge — enregistrez d'abord en .docx |
| XLSX | Classeurs Excel | Les tableaux se convertissent en tables Markdown |
| CSV | Données séparées par virgules | Converti en tables Markdown ; l'outil local-text le gère aussi |
Tarifs de file-md-json
Les tarifs ont été vérifiés dans le catalogue de production Roko du 06-10-2026. Chaque appel réussi est facturé ; l'enregistrement de règlement au moment de l'appel fait foi.
| Élément facturé | Prix |
|---|---|
| Par appel d'analyse | 0,001 $ |
Exemples de coût
Coût courant pour un contrat ou un rapport unique.
Dépense typique pour l'archivage et la recherche ; les tâches échouées ne sont pas facturées.
Appeler file-md-json en trois étapes
Le téléversement renvoie id. Transmettez-le comme input.file_id à invoke, puis récupérez le résultat terminé par task_id. N'exposez jamais de clé API côté client.
1. Téléverser un fichier
curl https://api.rokoapi.com/v1/tools/file-md-json/files \
-H "Authorization: Bearer $API_KEY" \
-F "file=@/path/to/report.pdf"2. Soumettre la tâche d'analyse
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. Récupérer le résultat
curl https://api.rokoapi.com/v1/tasks/$TASK_ID/result \
-H "Authorization: Bearer $API_KEY"invoke renvoie 202 avec un task_id ; une fois l'analyse terminée, lisez le md-json (schema_version 1.0) depuis l'endpoint de résultat. L'Idempotency-Key doit compter 8 à 64 caractères (lettres, chiffres, underscores ou tirets) ; un rejeu avec la même clé renvoie la tâche d'origine sans refacturation.
Limites à connaître avant usage
- Jusqu'à 10 Mo par fichier, exactement un fichier par téléversement.
- Les PDF scannés n'ont pas d'OCR — le texte sera absent de l'analyse.
- Les anciens formats binaires (.doc, .xls) ne sont pas pris en charge ; convertissez d'abord en DOCX/XLSX.
- Les résultats de tâches ont une durée de conservation — récupérez-les et stockez-les rapidement. N'exposez jamais de clé API côté client.
- La qualité d'analyse dépend de la structure du document ; les mises en page complexes, formules et tableaux imbriqués peuvent présenter des écarts.
FAQ file-md-json
Quels formats de fichiers file-md-json prend-il en charge ?
Actuellement PDF, DOCX, XLSX et CSV, jusqu'à 10 Mo par fichier.
Combien coûte file-md-json ?
Facturé à l'appel : 0,001 $, généré depuis le catalogue actuel des services d'outils. Les analyses échouées ne sont pas facturées ; le règlement suit les enregistrements à la soumission.
Quels champs contient la sortie md-json ?
Le JSON de résultat inclut schema_version, markdown (texte Markdown complet), structure_source, capabilities (indicateurs OCR, références de pages, boîtes englobantes, tableaux structurés) et un tableau warnings.
Quelle différence avec text-md-json ?
text-md-json traite les fichiers texte et code (txt/md/csv/code source) avec une conversion locale, moins cher (0,0001 $/appel) ; file-md-json analyse les documents binaires comme PDF/DOCX/XLSX via le canal de conversion à 0,001 $/appel.
Peut-on analyser des fichiers en lot ?
Oui. Chaque appel analyse un fichier ; enchaînez téléversements et soumissions côté client, avec un Idempotency-Key distinct par tâche.
Pourquoi un 403 ou une erreur de permission ?
Les appels d'outils exigent une clé API avec la permission d'invocation de l'outil activée. Activez file-md-json pour votre token dans la console puis réessayez.