Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Podprti formati datotek

Lekcija 2 od 16 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Edino merilo, ki šteje
  2. Štiri podprte kategorije
  3. Pogoste pasti
  4. Izberi čim bolj strukturiran format
  5. Ključne ugotovitve

Edino merilo, ki šteje

Preden se vprašaš, ali določen format deluje, si zastavi preprostejše vprašanje: ali datoteka vsebuje besedilo, ki ga je mogoče izvleči? API Files od xAI obdeluje besedilne datoteke. Če katero koli orodje iz nje lahko izvleče znake brez uporabe optičnega prepoznavanja znakov (OCR), je dokument verjetno sprejet. Čiste binarne datoteke – slike, zvok, video – sem ne spadajo; za sliko je pravilen pristop input_image v API-ju Responses, ne pa v API-ju Files.

To edino merilo pojasnjuje večino zavrnitev, na katere boš naletel. Pojasnjuje tudi, zakaj PDF finančnega poročila deluje brezhibno, medtem ko PDF z namiznega skenerja odpove: prvi nosi besedilno plast, drugi pa je le niz fotografij strani.

Štiri podprte kategorije

Podprti formati spadajo v štiri kategorije, vsaka ima svojo namensko rabo.

KategorijaFormatiKaj Grok izvleče
Pisarniški dokumentiPDF, DOCX, ODT, EPUB, RTFBesedilo, tabele, struktura razdelkov
Izvorna koda.py, .js, .ts, .java, .go, .rs, .cpp, HTML, CSS, XML in 80+ jezikovUvozi, odvisnosti, struktura datotek
Strukturirani podatkiCSV, TSV, JSON, JSON-LD, vCardHierarhija polj, statistika, trendi
Navadno besediloTXT, MDLinearna vsebina, naslovi in seznami v Markdownu

Pri pisarniških dokumentih ostaja PDF najpogostejši format; Grok iz njega izvleče besedilo, tabele in razčlenitev razdelkov. Wordov DOCX pri izvleku ohrani oblikovanje – krepko, ležeče, sezname – tako kot njegov odprtokodni ekvivalent ODT. EPUB postane zanimiv, ko delaš z daljšimi publikacijami, belimi knjigami ali celotnimi priročniki, RTF pa je kljub starosti še vedno dovolj razširjen, da ga podpiramo.

Izvorna koda je področje, kjer se API Files najbolj jasno razlikuje od kopiranja in lepljenja. Če pošlješ celotno datoteko payment.py namesto izolirane funkcije, se narava analize spremeni: Grok vidi uvoze, odvisnosti in organizacijo datotek, zato lahko zazna, da je izjema ujeta trideset vrstic višje ali da konstanta, definirana na vrhu, nasprotuje komentarju na dnu. Pokritih je več kot 80 jezikov z besedilno sintakso.

Formati podatkov so namenjeni predvsem kvantitativni analizi. CSV z mesečno prodajo omogoča Groku izračun odstopanj, prepoznavanje sezonskosti in povzemanje nabora podatkov z več tisoč vrsticami; konfiguracija JSON ali odgovor API-ja mu omogoča dostop do hierarhije in odnosov med polji, česar poravnana tabela ne bi pokazala. JSON-LD povezanim podatkom doda semantični kontekst, vCard pa pokriva vizitke. Nazadnje, TXT in MD delujeta po pričakovanjih, pri čemer Markdown ponuja prednost prenosa lahke strukture naslovov in seznamov.

Pogoste pasti

V proizvodnem okolju se nenehno pojavljajo štiri omejitve. Prva je velikost: 48 MB na datoteko; če jo presežeš, moraš dokument razdeliti. Druga je kodiranje: tvoje datoteke morajo biti v kodiranju UTF-8; izvoz v ISO-8859 ali Windows-1252 bo povzročil poškodovane naglašene znake, včasih subtilno – `é` postane `é` sredi pogodbe in to ostane neopaženo, dokler iskanje ne vrne ničesar. Tretja je odsotnost obdelave slik: PNG, JPG ali GIF sem ne spadajo, uporabiti moraš input_image. Četrta je primer skeniranega PDF-ja brez besedilne plasti OCR, ki bo sicer sprejet ob nalaganju, a ob poizvedbi ne bo vrnil rezultatov.

Zadnja situacija zahteva preprosto navado: preden naložiš serijo PDF-jev negotovega izvora, odpri enega in poskusi z miško izbrati odstavek. Če ni mogoče izbrati ničesar, morajo tvoji dokumenti najprej skozi postopek OCR.

Izberi čim bolj strukturiran format

Ko iste informacije obstajajo v več oblikah, vedno izberi tisto, ki je najbolj strukturirana. Za analizo poročil raje uporabi izvirni PDF ali DOCX, ki ohranjata hierarhijo, namesto ravnega besedilnega izvoza. Za analizo podatkov bosta CSV za tabele in JSON za hierarhične podatke dala boljše rezultate kot izvoz preglednice, pretvorjen v navadno besedilo. Za pregled kode pošlji izvirno izvorno datoteko z njeno originalno končnico. Za dokumentacijo delujeta Markdown ali PDF, odvisno od tega, kaj imaš na voljo pri viru. Pravilo se skrči v en stavek: vsaka raven strukture, ki jo ohraniš, je raven konteksta, ki je modelu ni treba rekonstruirati.

Ključne ugotovitve

  • API Files podpira dokumente (PDF, DOCX, EPUB), kodo (80+ jezikov), podatke (CSV, JSON) in navadno besedilo
  • Omejitev je 48 MB na datoteko v kodiranju UTF-8
  • Slike in binarne datoteke niso podprte – za slike uporabi input_image
  • Za boljšo analizo vedno izberi čim bolj strukturiran format