Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Spravujte svoje súbory: zoznam, získanie, odstránenie

Lekcia 3 z 16 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Čo sa deje po stovkom nahraní
  2. Urobte si inventár
  3. Overenie konkrétneho súboru
  4. Odstránenie a čo skontrolovať predtým
  5. Udržiavajte svoje úložisko čisté
  6. Kľúčové poznatky

Čo sa deje po stovkom nahraní

Nahranie súboru trvá tri sekundy; nájsť ten, ktorý ste odoslali pred šiestimi týždňami, trvá oveľa dlhšie, ak ste si to vopred neplánovali. Po úvodných testoch sa na účte nahromadia desiatky a následne stovky dokumentov. Niektoré sú zastarané, iné duplicitné a ďalšie sú stále využívané bežiacimi aplikáciami. Files API poskytuje tri operácie na správu tohto inventára: zoznam, získanie a odstránenie. Zatiaľ čo je objem malý, môžu sa zdať druhotné, no neskôr sa stanú nevyhnutnými.

Urobte si inventár

GET /v1/files vráti všetky súbory nahrané na váš účet:

curl https://api.x.ai/v1/files \
  -H "Authorization: Bearer $XAI_API_KEY"

Odpoveďou je stránkovaný zoznam, kde každá položka opakuje metadáta viditeľné pri nahrávaní:

{
  "object": "list",
  "data": [
    {
      "id": "file_abc123",
      "object": "file",
      "bytes": 2458901,
      "created_at": 1710000000,
      "filename": "rapport-annuel.pdf",
      "purpose": "assistants"
    },
    {
      "id": "file_def456",
      "object": "file",
      "bytes": 15230,
      "created_at": 1710100000,
      "filename": "données-clients.csv",
      "purpose": "assistants"
    }
  ]
}

Tento pohľad rieši tri veľmi konkrétne situácie: získanie file_id, ktoré ste pri nahrávaní neuložili, overenie skutočnej veľkosti dokumentu, ktorý sa zdá byť neprimerane veľký, a identifikáciu kandidátov na odstránenie zoradením podľa created_at. Je to tiež jediné miesto, kde na prvý pohľad uvidíte, že tá istá správa bola odoslaná trikrát pod tromi rôznymi názvami.

Overenie konkrétneho súboru

Keď už poznáte identifikátor, GET /v1/files/{file_id} dotazuje jediný dokument:

curl https://api.x.ai/v1/files/file_abc123 \
  -H "Authorization: Bearer $XAI_API_KEY"

Získate rovnaké informácie ako pri nahrávaní: identifikátor, názov, veľkosť, dátum vytvorenia a účel. Najužitočnejším využitím tohto volania je prevencia. Pred spustením procesu, ktorý odkazuje na file_id uložený dlhý čas vo vašej databáze, vás kontrola trvajúca niekoľko milisekúnd ušetrí od chyby uprostred reťazca fakturovaných požiadaviek.

Odstránenie a čo skontrolovať predtým

Odstránenie sa vykonáva pomocou DELETE /v1/files/{file_id} a odpoveď operáciu potvrdzuje:

curl -X DELETE https://api.x.ai/v1/files/file_abc123 \
  -H "Authorization: Bearer $XAI_API_KEY"
{
  "id": "file_abc123",
  "object": "file",
  "deleted": true
}

Pred stlačením spúšte sú potrebné dve kontroly. Po prvé, súbor môže byť odkazovaný v kolekcii – koncept, ktorý podrobne rozoberieme v nadchádzajúcich lekciách. Jeho odstránenie cez Files API ho automaticky neodstráni z kolekcie, čo vám v indexe zanechá mŕtvy odkaz: najprv ho odstráňte z kolekcie a až potom z úložiska. Po druhé, súbor môže byť používaný aktívnymi pracovnými postupmi; akákoľvek aplikácia, ktorá má tento file_id vo svojej databáze, začne hneď po odstránení dostávať chyby, často v produkcii a zriedka v čase, keď sledujete logy.

Udržiavajte svoje úložisko čisté

Pomenovávanie je vaším prvým nástrojom správy, pretože pôvodný názov zostáva v metadátach a predstavuje jedinú čitateľnú značku v zozname sto položiek. rapport-q1-2026.pdf vám bude niečo znamenať aj o osem mesiacov; document.pdf nikdy. To isté platí pre api-specs-v2.json oproti data.json. Urobte si z toho zvyk pri príprave súboru na disku, nie až v čase nahrávania: do systému sa prenáša lokálny názov.

Nahrané súbory zostávajú uložené na neurčito, bez automatického vypršania platnosti. Štvrťročná rutina čistenia stačí na zabránenie rozrastaniu, a to v troch krokoch:

  1. Vypíšte svoje súbory pomocou GET /v1/files
  2. Identifikujte tie, ktoré sa už nepoužívajú, podľa dátumu vytvorenia alebo názvu
  3. Odstráňte ich pomocou DELETE /v1/files/{file_id}

Pri týchto operáciách sa vyskytujú tri chybové kódy, ktoré sa dajú okamžite diagnostikovať. 404 signalizuje neexistujúci alebo už odstránený súbor, čo je typický prípad dvakrát spusteného skriptu na čistenie. 401 vzniká chýbajúcim alebo neplatným API kľúčom, často ide o premennú prostredia, ktorá sa nenačítala v aktuálnom shelri. 413 indikuje, že súbor presahuje povolených 48 MB, a vyskytuje sa pri nahrávaní, nie počas správy.

Kľúčové poznatky

  • GET /v1/files vypíše všetky vaše súbory s ich metadátami
  • GET /v1/files/{id} získava konkrétny súbor
  • DELETE /v1/files/{id} trvalo odstraňuje súbor
  • Pomenúvajte svoje súbory explicitne, aby ste uľahčili správu
  • Pred odstránením skontrolujte závislosti (kolekcie, pracovné postupy)