Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Beheer uw bestanden: lijst, ophalen, verwijderen

Les 3 van 16 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. Wat gebeurt er na de honderste upload
  2. Inventarisatie maken
  3. Een specifiek bestand verifiëren
  4. Verwijderen en wat u eerst moet controleren
  5. Houd uw opslag schoon
  6. Belangrijkste punten

Wat gebeurt er na de honderste upload

Het uploaden van een bestand duurt drie seconden; het vinden van het bestand dat u zes weken geleden heeft verzonden, duurt veel langer als u niet vooruit heeft gepland. Na de initiële tests verzamelt een account tientallen en vervolgens honderden documenten. Sommige zijn verouderd, andere zijn gedupliceerd en weer andere worden gebruikt door applicaties die nog steeds actief zijn. De Files API biedt drie bewerkingen om deze inventaris te beheren: lijst weergeven, ophalen en verwijderen. Ze lijken secundair zolang het volume laag is, maar worden later onmisbaar.

Inventarisatie maken

GET /v1/files retourneert alle bestanden die naar uw account zijn geüpload:

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

Het antwoord is een gepagineerde lijst, waarbij elke entry de metadata herhaalt die bij het uploaden werd gezien:

{
  "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"
    }
  ]
}

Deze weergave lost drie zeer concrete situaties op: het herstellen van een file_id die u niet heeft opgeslagen tijdens het uploaden, het controleren van de werkelijke grootte van een document dat abnormaal zwaar lijkt, en het identificeren van kandidaten voor verwijdering door te sorteren op created_at. Het is ook de enige plek waar u in één oogopslag ziet dat hetzelfde rapport drie keer onder drie verschillende namen is verzonden.

Een specifiek bestand verifiëren

Wanneer u de identifier al kent, vraagt GET /v1/files/{file_id} een enkel document op:

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

U haalt dezelfde informatie op als bij het uploaden: identifier, naam, grootte, aanmaakdatum en doel. Het nuttigste gebruik van deze call is defensief. Voordat u een proces start dat verwijst naar een file_id die al lang in uw database is opgeslagen, bespaart een controle van enkele milliseconden u een fout midden in een keten van gefactureerde requests.

Verwijderen en wat u eerst moet controleren

Verwijderen gebeurt met DELETE /v1/files/{file_id} en het antwoord bevestigt de bewerking:

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

Twee controles zijn vereist voordat u de trekker overhaalt. Ten eerste kan het bestand worden gebruikt in een collectie—een concept dat we in komende lessen in detail zullen bespreken. Het verwijderen ervan via de Files API verwijdert het niet automatisch uit de collectie, waardoor u met een dode referentie in uw index blijft zitten: verwijder het eerst uit de collectie en vervolgens uit de opslag. Ten tweede kan het bestand worden gebruikt door actieve workflows; elke applicatie die deze file_id in zijn database houdt, ontvangt foutmeldingen zodra de verwijdering is uitgevoerd, vaak in productie en zelden terwijl u logs bewaakt.

Houd uw opslag schoon

Naamgeving is uw eerste beheertools, omdat de oorspronkelijke naam in de metadata wordt bewaard en het enige leesbare merkteken vormt in een lijst van honderd entries. rapport-q1-2026.pdf zal over acht maanden iets voor u betekenen; document.pdf nooit. Dezelfde redenering geldt voor api-specs-v2.json versus data.json. Maak hier een gewoonte van wanneer u het bestand op uw schijf voorbereidt, niet op het moment van uploaden: het is de lokale naam die wordt verzonden.

Geüploade bestanden blijven onbeperkt opgeslagen, zonder automatische verloopdatum. Een kwartaallijkse opschoningsroutine volstaat om drift te voorkomen, in drie stappen:

  1. Maak een lijst van uw bestanden met GET /v1/files
  2. Identificeer die welke niet meer in gebruik zijn, op basis van aanmaakdatum of naam
  3. Verwijder ze met DELETE /v1/files/{file_id}

Drie foutcodes komen bij deze bewerkingen regelmatig voor en zijn direct te diagnosticeren. Een 404 signaleert een niet-bestaand of reeds verwijderd bestand, een typisch geval van een opschoningsscript dat twee keer is uitgevoerd. Een 401 komt voort uit een ontbrekende of ongeldige API-sleutel, vaak een omgevingsvariabele die niet is geladen in de huidige shell. Een 413 geeft aan dat het bestand de toegestane 48 MB overschrijdt en treedt op bij het uploaden, niet tijdens het beheer.

Belangrijkste punten

  • GET /v1/files geeft een lijst van al uw bestanden met hun metadata
  • GET /v1/files/{id} haalt een specifiek bestand op
  • DELETE /v1/files/{id} verwijdert een bestand permanent
  • Geef uw bestanden expliciete namen om het beheer te vergemakkelijken
  • Controleer afhankelijkheden (collecties, workflows) voordat u verwijdert