Files API
Eine Files API ist eine Schnittstelle, über die Programme Dateien wie PDFs, Bilder oder Tabellen auf den Server eines KI-Anbieters hochladen und dort ablegen. Das Modell kann anschließend mit diesen Dateien arbeiten, ohne dass der Inhalt bei jeder Anfrage erneut mitgeschickt werden muss.
Programme reden über festgelegte Schnittstellen miteinander. Eine solche Schnittstelle nennt man API, also eine Art Steckdose, an die sich fremde Software anschließen darf. Eine Files API ist eine spezielle Variante davon: Über sie schickt ein Programm ganze Dateien an den Anbieter eines KI-Dienstes, etwa ein PDF, ein Foto oder eine Tabelle. Die Datei wird dort gespeichert und bekommt eine eindeutige Nummer zurück, eine sogenannte Datei-ID. Ab diesem Moment genügt es, diese Nummer zu nennen, damit das KI-Modell auf den Inhalt zugreifen kann. Man muss die Datei also nicht bei jeder einzelnen Frage neu übertragen.
Warum Anbieter Dateien getrennt behandeln
Ein Sprachmodell nimmt normalerweise nur Text entgegen, den man direkt in die Anfrage schreibt. Für eine kurze Frage ist das kein Problem. Ein Geschäftsbericht mit 300 Seiten passt aber nicht bequem in so eine Anfrage. Er wäre riesig, langsam zu übertragen und würde bei jeder Nachfrage erneut durch die Leitung wandern. Die Files API löst genau dieses Problem, indem sie das Hochladen vom Fragen trennt.
Der zweite Grund ist Geld. Bei den meisten Anbietern zahlt man nach Textmenge, gemessen in sogenannten Token, also kleinen Wortbausteinen. Wer ein langes Dokument zehnmal mitschickt, zahlt es auch mehrfach. Liegt die Datei dagegen einmal auf dem Server, lassen sich Teile der Verarbeitung wiederverwenden. Bei Dokumenten, die viele Nutzer immer wieder abfragen, spart das spürbar.
Drittens erlaubt eine Files API überhaupt erst bestimmte Funktionen. Ein Modell, das Programmcode ausführt, braucht die Datendatei als echte Datei auf einer Festplatte. Auch eine Bildanalyse funktioniert nur, wenn das Bild als Bild vorliegt und nicht als abgetippte Beschreibung.
Vom Upload bis zur Datei-ID
Der Ablauf besteht meist aus drei Schritten. Zuerst schickt das Programm die Datei an eine feste Internetadresse des Anbieters, oft mit dem Zusatz, wofür sie gedacht ist. Der Server antwortet mit einer Kennung, die etwa so aussieht: file-abc123. Diese Kennung ist der Griff, an dem man die Datei später wieder anfasst.
Im zweiten Schritt stellt man die eigentliche Frage. Statt des Dokumententextes steht nun nur noch die Kennung in der Anfrage, zusammen mit einem Satz wie: Fasse die Risiken aus diesem Bericht zusammen. Das Modell holt sich den Inhalt selbst und antwortet. Im dritten Schritt kann man die Datei wieder löschen, wenn sie nicht mehr gebraucht wird.
Wichtig ist die Abgrenzung zu zwei ähnlichen Dingen. Eine Files API ist kein Cloud-Speicher wie Google Drive, denn sie ist nur für die Zusammenarbeit mit dem Modell gedacht und hat oft Größen- und Zeitgrenzen. Sie ist auch keine Suche über eigene Dokumente: Das Modell durchsucht nicht automatisch alle hochgeladenen Dateien, sondern nur die, die man in der Anfrage ausdrücklich nennt. Typische Grenzen liegen bei einigen hundert Megabyte pro Datei, und viele Anbieter löschen Uploads nach einigen Tagen von selbst.
Wer damit täglich arbeitet
Sichtbar wird die Technik überall dort, wo man in einem KI-Chat eine Büroklammer anklickt und ein Dokument anhängt. Im Hintergrund läuft fast immer eine Files API. Dasselbe gilt für Apps, die Rechnungen einlesen, Bewerbungsunterlagen sortieren oder aus einer Tabelle ein Diagramm bauen.
In Nachrichten aus der Tech-Branche taucht der Begriff auf, wenn Anbieter ihre Schnittstellen erweitern, etwa um größere Dateien oder neue Formate wie Video. Für Entwicklerinnen und Entwickler sind solche Meldungen relevant, weil sie festlegen, was eine App überhaupt anbieten kann. Wer beruflich mit sensiblen Unterlagen arbeitet, achtet zusätzlich darauf, wo die hochgeladenen Dateien gespeichert werden und wie lange sie dort liegen bleiben. Das ist bei Personaldaten oder Patientenakten keine Nebensache, sondern eine rechtliche Frage.