Salt la conținutul principal
Română— Alege o limbă
Meniu

Formate de fișiere acceptate

Lecția 2 din 16 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Singurul criteriu care contează
  2. Cele patru categorii acceptate
  3. Capcane frecvente
  4. Alegeți formatul cel mai structurat posibil
  5. Puncte cheie

Singurul criteriu care contează

Înainte de a vă întreba dacă un format specific funcționează, puneți-vă o întrebare mai simplă: conține fișierul text extragibil? API-ul Files de la xAI gestionează fișiere text. Dacă orice instrument poate extrage caractere din el fără recunoaștere optică a caracterelor (OCR), documentul este probabil acceptat. Fișierele binare pure—imagini, audio, video—nu își au locul aici; pentru o imagine, abordarea corectă este input_image în API-ul Responses, nu în Files API.

Acest singur criteriu explică majoritatea respingerilor pe care le veți întâlni. Explică, de asemenea, de ce un raport financiar PDF funcționează perfect, în timp ce un PDF provenit de la un scanner de birou eșuează: primul conține un strat de text, al doilea este doar o serie de fotografii ale paginilor.

Cele patru categorii acceptate

Formatele acceptate se împart în patru categorii, fiecare având utilizările sale preferate.

CategorieFormateCe extrage Grok
Documente de birouPDF, DOCX, ODT, EPUB, RTFText, tabele, structura secțiunilor
Cod sursă.py, .js, .ts, .java, .go, .rs, .cpp, HTML, CSS, XML și peste 80 de limbajeImporturi, dependențe, structura fișierelor
Date structurateCSV, TSV, JSON, JSON-LD, vCardIerarhia câmpurilor, statistici, tendințe
Text simpluTXT, MDConținut liniar, titluri și liste Markdown

În ceea ce privește documentele de birou, PDF rămâne formatul cel mai comun, iar Grok extrage textul, tabelele și defalcarea pe secțiuni. Un DOCX Word își păstrează formatarea—aldin, italic, liste—în timpul extragerii, la fel ca echivalentul său open-source, ODT. EPUB devine interesant imediat ce lucrați la publicații lungi, o carte albă sau un manual întreg, iar RTF, deși mai vechi, rămâne suficient de comun pentru a fi suportat.

Codul sursă este domeniul în care API-ul Files se distinge cel mai clar de simpla copiere-lipește. Trimiterea fișierului payment.py în întregime, în loc de o funcție izolată, schimbă natura analizei: Grok vede importurile, dependențele și organizarea fișierelor și poate, prin urmare, să observe că o excepție este capturată cu treizeci de linii mai sus sau că o constantă definită la început contrazice un comentariu de la final. Sunt acoperite peste 80 de limbaje cu sintaxă bazată pe text.

Formatele de date servesc în primul rând analizei cantitative. Un CSV cu vânzările lunare permite lui Grok să calculeze variațiile, să identifice sezonalitatea și să rezume un set de date de câteva mii de linii; o configurație JSON sau un răspuns API îi oferă acces la ierarhia și relațiile dintre câmpuri, lucru pe care un tabel aplatizat nu l-ar arăta. JSON-LD adaugă context semantic datelor interconectate, iar vCard acoperă cartelele de contact. În final, TXT și MD funcționează conform așteptărilor, Markdown oferind avantajul de a transmite o structură ușoară de titluri și liste.

Capcane frecvente

Patru constrângeri apar constant în producție. Prima este dimensiunea: 48 MB per fișier, dincolo de care trebuie să divizați documentul. A doua este codificarea: fișierele dumneavoastră trebuie să fie în UTF-8, iar o exportare în ISO-8859 sau Windows-1252 va produce caractere accentuate corupte, uneori subtil—un `é` devenind `é` în mijlocul unui contract poate trece neobservat până când o căutare nu returnează niciun rezultat. A treia este lipsa procesării imaginilor: PNG, JPG sau GIF nu își au locul aici, trebuie să utilizați input_image. A patra este cazul unui PDF scanat fără un strat de text OCR, care va fi acceptat la încărcare, dar nu va returna niciun rezultat la interogare.

Această ultimă situație impune un obicei simplu: înainte de a încărca un lot de PDF-uri de origine incertă, deschideți unul și încercați să selectați un paragraf cu mouse-ul. Dacă nimic nu se selectează, documentele dumneavoastră trebuie să treacă printr-un proces OCR înainte de încărcare.

Alegeți formatul cel mai structurat posibil

Când aceeași informație există sub multiple forme, alegeți întotdeauna varianta cea mai structurată. Pentru analiza rapoartelor, preferați PDF-ul sau DOCX-ul original, care păstrează ierarhia, în detrimentul unui export text plat. Pentru analiza datelor, un CSV pentru tabele și JSON pentru date ierarhice vor oferi rezultate mai bune decât un export din foaie de calcul transformat în text simplu. Pentru o revizuire a codului, trimiteți fișierul sursă original cu extensia sa originală. Pentru documentație, Markdown sau PDF funcționează în funcție de ceea ce aveți la sursă. Regula se rezumă la o singură propoziție: fiecare nivel de structură pe care îl păstrați este un nivel de context pe care modelul nu va trebui să îl reconstruiască.

Puncte cheie

  • API-ul Files acceptă documente (PDF, DOCX, EPUB), cod (peste 80 de limbaje), date (CSV, JSON) și text simplu
  • Limita este de 48 MB per fișier, cu codificare UTF-8
  • Imaginile și fișierele binare nu sunt acceptate—utilizați input_image pentru imagini
  • Preferați formatul cel mai structurat posibil pentru a obține o analiză mai bună