Zum Hauptinhalt springen
Lade eine Batch-Eingabedatei als Multipart-Formular hoch, speichere die zurückgegebene id und lies Metadaten und Bytes der Datei über diese ID wieder aus. Die Beispiele verwenden einen client, der wie unter Installation erstellt wurde.

Datei hochladen

TypeScript und Python laden mit einer SDK-Methode hoch, die POST /v1/batches/files sendet. Die anderen SDKs können kein Multipart senden, daher schicken sie das Formular mit dem Standard-HTTP-Client an POST /v1/files.

Upload-Optionen

Diese Optionen gelten für die Upload-Methoden in TypeScript und Python. In den rohen Multipart-Anfragen sendest du purpose und file als Formularfelder.

Datei wieder auslesen

Ersetze file_123 durch die ID, die der Upload zurückgegeben hat. In Python erreichst du sie auch über client.files: create(params) lädt wie upload_file hoch, list() listet auf, retrieve(id) liest die Metadaten und content(id) die Bytes. Rust hat keine Dateimethoden.
Die Datei-Endpunkte sind in der Beta und benötigen einen aktivierten Batch-Anbieter.

Datei-ID speichern: Dateien lassen sich nicht auflisten

Speichere die id jeder hochgeladenen Datei. Die Listenmethoden rufen GET /v1/files auf, das 400 mit dem Code not_supported und dem Grund file_list_not_supported_with_shared_gateway_key zurückgibt. Der vollständige Vertrag steht in der Files-API-Referenz.

Antwort

FileObject, vom Upload und von den Metadaten-Methoden:
Zuletzt geändert am 5. November 2026