Formats de fichiers supportes

Quels fichiers pouvez-vous envoyer a Grok ?

La Files API de xAI supporte une large gamme de formats textuels. Comprendre les formats acceptes vous evite les erreurs d’upload et vous permet de choisir le format optimal pour chaque cas d’usage.

Le principe fondamental : la Files API traite les fichiers textuels. Si votre document contient du texte extractible, il est probablement supporte. Les fichiers purement binaires (images, audio, video) ne passent pas par cette API — pour les images, utilisez input_image dans l’API Responses.

Documents bureautiques

Les formats de documents les plus courants sont pris en charge :

• PDF : le format le plus utilise. Grok extrait le texte, les tableaux et la structure des sections. Les PDF scannes (images) ne sont pas exploitables via cette API
• DOCX : documents Word. La mise en forme (gras, italique, listes) est preservee dans l’extraction
• ODT : format OpenDocument, equivalent libre de DOCX
• EPUB : livres numeriques. Utile pour analyser des publications longues
• RTF : Rich Text Format, ancien mais encore repandu

Code source

La Files API excelle pour l’analyse de code. Vous pouvez uploader des fichiers dans plus de 80 langages :

• Python (.py), JavaScript (.js), TypeScript (.ts)
• Java (.java), Go (.go), Rust (.rs), C++ (.cpp)
• HTML, CSS, XML
• Et la majorite des langages avec syntaxe textuelle

L’interet principal : envoyer un fichier de code complet plutot qu’un extrait colle dans le prompt. Grok peut ainsi analyser les imports, les dependances et la structure globale du fichier.

Donnees structurees

Les formats de donnees sont particulierement utiles pour l’analyse :

• CSV et TSV : tableaux de donnees. Grok peut calculer des statistiques, identifier des tendances et resumer de grands jeux de donnees
• JSON : donnees structurees, configurations, reponses d’API. Le modele comprend la hierarchie et les relations entre les champs
• JSON-LD : donnees liees avec contexte semantique
• vCard : fiches de contact

Texte brut

Les formats texte simples fonctionnent sans surprise :

• TXT : texte sans mise en forme
• MD (Markdown) : texte avec structure legere (titres, listes, liens)

Limites a connaitre

Plusieurs contraintes encadrent l’utilisation de la Files API :

• Taille maximale : 48 MB par fichier. Au-dela, vous devez decouper votre document
• Encodage : les fichiers doivent etre en UTF-8. Les encodages exotiques (ISO-8859, Windows-1252) peuvent causer des problemes de caracteres
• Pas d’images : les fichiers image (PNG, JPG, GIF) ne sont pas traites par la Files API. Utilisez input_image pour envoyer des images a Grok
• PDF scannes : un PDF qui contient uniquement des images scannees (sans couche texte OCR) ne sera pas exploitable

Choisir le bon format

Voici les recommandations selon votre cas d’usage :

• Analyse de rapport : PDF ou DOCX, qui preservent la structure
• Analyse de donnees : CSV pour les tableaux, JSON pour les donnees hierarchiques
• Review de code : le fichier source original (.py, .ts, .java…)
• Documentation : Markdown ou PDF selon la source

Points cles a retenir

• La Files API supporte les documents (PDF, DOCX, EPUB), le code (80+ langages), les donnees (CSV, JSON) et le texte brut
• La limite est de 48 MB par fichier en encodage UTF-8
• Les images et fichiers binaires ne sont pas supportes — utilisez input_image pour les images
• Privilegiez le format le plus structure possible pour obtenir de meilleures analyses