Files-API: Dateien hochladen und verwalten, gespeichert in der EU

POST /v1/files lädt eine Datei als multipart/form-data mit zwei Feldern hoch: file und purpose. Nutzen Sie purpose batch für Batch-Eingaben oder user_data für Dateien, die ein Werkzeug wie die Codeausführung lesen soll. Die Antwort ist ein Dateiobjekt mit id, bytes, filename, purpose und created_at. Über die id verweisen Sie überall sonst auf die Datei.

GET /v1/files listet Ihre Dateien, GET /v1/files/{file_id} liefert ein einzelnes Objekt, GET /v1/files/{file_id}/content lädt den Inhalt herunter und DELETE /v1/files/{file_id} entfernt die Datei. Ausgabe- und Fehlerdateien von Batches erscheinen in derselben Liste mit purpose batch_output.

Eine Batch-Eingabedatei ist JSON Lines: eine Anfrage pro Zeile, jeweils mit einer selbst gewählten custom_id, method POST, der url wie /v1/chat/completions oder /v1/embeddings und einem body, der genau dem entspricht, was Sie an diesen Endpunkt senden würden. Alle Zeilen einer Datei sollten denselben Endpunkt ansprechen.

Wählen Sie eine aussagekräftige custom_id, etwa eine Ticketnummer oder Dokument-ID, denn Ergebnisse kommen in beliebiger Reihenfolge zurück und werden über diesen Wert zugeordnet. Prüfen Sie die Datei vor dem Upload: Jede Zeile muss gültiges JSON sein, und schon eine fehlerhafte Zeile kann die Validierung des ganzen Batches scheitern lassen.

Dateien liegen in europäischen Rechenzentren, sind nur mit Schlüsseln Ihrer Organisation zugänglich und werden nie zum Training von Modellen verwendet. Behandeln Sie sie wie jede andere Kopie Ihrer Daten: Löschen Sie Eingabedateien, sobald der Batch abgeschlossen ist und Sie die Ergebnisse haben, und Ausgabedateien, sobald sie verarbeitet sind.

Ein kurzer Aufräumschritt am Ende jedes Jobs genügt. Er hält die Liste übersichtlich und begrenzt, wie viele sensible Daten im Speicher liegen. Wie lange nicht gelöschte Dateien aufbewahrt werden, hängt von Ihrem Vertrag ab und wird mit Ihnen abgestimmt.

Ein Upload ohne purpose oder mit einem nicht unterstützten Wert ergibt einen 400-Fehler. Dateien über der Maximalgröße werden ebenfalls abgelehnt; teilen Sie große Eingaben auf mehrere Dateien und Batches auf. Die Größengrenze hängt von Ihrem Tarif ab und wird mit Ihnen abgestimmt.

Eine Datei-ID, die nicht existiert oder einer anderen Organisation gehört, liefert 404. Den Inhalt einer Datei, die noch geschrieben wird, etwa die Ausgabe eines laufenden Batches, können Sie nicht herunterladen; warten Sie auf den Status completed. Wenn Sie eine Datei löschen, die ein laufender Batch nutzt, kann dieser scheitern. Löschen Sie Eingaben also erst danach.