Ondersteunde bestandsindelingen
Op deze pagina
Het enige criterium dat telt
Voordat u zich afvraagt of een specifieke indeling werkt, stelt u zich een eenvoudigere vraag: bevat het bestand extraheerbare tekst? De xAI Files API verwerkt tekstbestanden. Als een willekeurig hulpmiddel tekens uit het bestand kan halen zonder optical character recognition (OCR), wordt het document waarschijnlijk geaccepteerd. Puur binaire bestanden—afbeeldingen, audio, video—horen hier niet thuis; voor een afbeelding is de juiste aanpak input_image in de Responses API, niet de Files API.
Dit ene criterium verklaart de meeste afwijzingen die u zult tegenkomen. Het verklaart ook waarom een financieel rapport in PDF perfect werkt, terwijl een PDF van een desktopscanner faalt: de eerste bevat een tekstlaag, de tweede is slechts een reeks foto’s van pagina’s.
De vier ondersteunde categorieën
Ondersteunde indelingen vallen in vier categorieën, elk met hun eigen voorkeursgebruik.
| Categorie | Indelingen | Wat Grok extraheert |
|---|---|---|
| Office-documenten | PDF, DOCX, ODT, EPUB, RTF | Tekst, tabellen, sectiestructuur |
| Broncode | .py, .js, .ts, .java, .go, .rs, .cpp, HTML, CSS, XML en 80+ talen | Imports, afhankelijkheden, bestandsstructuur |
| Gestructureerde gegevens | CSV, TSV, JSON, JSON-LD, vCard | Veldhiërarchie, statistieken, trends |
| Platte tekst | TXT, MD | Lineaire inhoud, Markdown-koppen en lijsten |
Aan de kant van office-documenten blijft PDF de meest voorkomende indeling; Grok extraheert hieruit de tekst, tabellen en sectie-indeling. Een Word DOCX behoudt zijn opmaak—vet, cursief, lijsten—in de extractie, net als het open-source-equivalent ODT. EPUB wordt interessant zodra u werkt aan lange publicaties, een whitepaper of een volledige handleiding, en RTF is, hoewel ouder, nog steeds gebruikelijk genoeg om te ondersteunen.
Broncode is waar de Files API zich het duidelijkst onderscheidt van kopiëren en plakken. Het volledig verzenden van payment.py in plaats van een geïsoleerde functie verandert de aard van de analyse: Grok ziet de imports, afhankelijkheden en bestandsorganisatie, en kan daardoor ontdekken dat een uitzondering dertig regels eerder wordt afgevangen of dat een constante die bovenaan is gedefinieerd, in tegenspraak is met een commentaar onderaan. Meer dan 80 talen met tekstgebaseerde syntaxis worden ondersteund.
Gegevensindelingen dienen voornamelijk voor kwantitatieve analyse. Een CSV met maandelijkse verkopen stelt Grok in staat varianties te berekenen, seizoensgebondenheid te detecteren en een dataset van enkele duizenden regels samen te vatten; een JSON-configuratie of API-respons geeft toegang tot de hiërarchie en relaties tussen velden, wat een afgeplatte tabel niet zou laten zien. JSON-LD voegt semantische context toe aan gekoppelde gegevens en vCard dekt visitekaartjes. Tot slot werken TXT en MD zoals verwacht, waarbij Markdown het voordeel biedt een lichtgewicht structuur van koppen en lijsten over te brengen.
Veelvoorkomende valkuilen
Vier beperkingen komen in productie voortdurend naar voren. De eerste is grootte: 48 MB per bestand; daarboven moet u het document splitsen. De tweede is codering: uw bestanden moeten in UTF-8 zijn, en een export in ISO-8859 of Windows-1252 zal beschadigde tekens met accenten opleveren, soms subtiel—een `é` die `é` wordt midden in een contract, valt niet op totdat een zoekopdracht niets oplevert. De derde is het ontbreken van afbeeldingsverwerking: PNG, JPG of GIF horen hier niet thuis, u moet input_image gebruiken. De vierde betreft een gescande PDF zonder OCR-tekstlaag, die bij het uploaden wel wordt geaccepteerd, maar geen resultaten oplevert bij bevraging.
Deze laatste situatie vraagt om een eenvoudige gewoonte: voordat u een batch PDF’s van onzekere herkomst uploadt, opent u er één en probeert u een alinea met de muis te selecteren. Als er niets te selecteren valt, moeten uw documenten eerst een OCR-verwerking ondergaan.
Kies de meest gestructureerde indeling die mogelijk is
Wanneer dezelfde informatie in meerdere vormen bestaat, kiest u altijd de meest gestructureerde. Voor rapportanalyse geeft u de voorkeur aan de oorspronkelijke PDF of DOCX, die de hiërarchie behouden, boven een platte tekstexport. Voor gegevensanalyse leveren een CSV voor tabellen en JSON voor hiërarchische gegevens betere resultaten op dan een spreadsheet-export die is omgezet in platte tekst. Voor een code-review stuurt u het oorspronkelijke bronbestand met de oorspronkelijke extensie. Voor documentatie werkt Markdown of PDF, afhankelijk van wat u bij de bron heeft. De regel komt neer op één zin: elk niveau van structuur dat u behoudt, is een niveau context dat het model niet hoeft te reconstrueren.
Belangrijkste punten
- De Files API ondersteunt documenten (PDF, DOCX, EPUB), code (80+ talen), gegevens (CSV, JSON) en platte tekst
- De limiet is 48 MB per bestand in UTF-8-codering
- Afbeeldingen en binaire bestanden worden niet ondersteund—gebruik
input_imagevoor afbeeldingen - Geef de voorkeur aan de meest gestructureerde indeling die mogelijk is voor een betere analyse