Wenn deine Anwendung Fragen zu den Unterlagen eines bestimmten Kunden beantworten soll, etwa zu seinem Vertrag oder seiner Preisliste, lädst du diese Dokumente für den Endnutzer hoch. Das Brain sucht bei späteren Anfragen derselben Person automatisch die passenden Stellen heraus und gibt sie dem Modell mit. Du musst dafür keine eigene Suche und keine eigenen Embeddings bauen.
Schritt 1: Den Endnutzer anlegen
Für den Upload brauchst du die id des Endnutzers, nicht deine eigene Kennung. Du bekommst sie mit POST /v1/end-users:
curl -X POST https://api.flowmodels.one/v1/end-users \
-H "Authorization: Bearer at_dein_schluessel" \
-H "Content-Type: application/json" \
-d '{"external_identifier": "kunde-1042"}'
Gibt es den Endnutzer schon, bekommst du den vorhandenen Datensatz zurück. Die id in der Antwort verwendest du im nächsten Schritt.
Schritt 2: Die Datei hochladen
Achte auf den Pfad: Hier steht end_users mit Unterstrich, die Verwaltung der Endnutzer nutzt dagegen end-users mit Bindestrich.
curl -X POST https://api.flowmodels.one/v1/end_users/018f1234-5678-7abc-9def-0123456789ab/files \
-H "Authorization: Bearer at_dein_schluessel" \
-H "Accept: application/json" \
-F "file=@angebot-2026.pdf" \
-F "purpose=user_data"
purpose ist immer user_data. Den Content-Type mit Boundary setzt dein HTTP-Client bei multipart/form-data selbst.
Schritt 3: Warten, bis die Datei bereit ist
Der Upload antwortet mit HTTP 201 und status: "pending". Die Datei ist dann gespeichert, aber noch nicht nutzbar. Wir lesen den Text aus und bereiten ihn für die Suche auf. Erst danach finden spätere Anfragen die passenden Stellen. Den Stand siehst du mit:
curl https://api.flowmodels.one/v1/end_users/018f1234-5678-7abc-9def-0123456789ab/files \
-H "Authorization: Bearer at_dein_schluessel"
Vorübergehende Fehler bei der Verarbeitung wiederholen wir selbst. Ein Dokument, aus dem sich kein Text lesen lässt, etwa ein reiner Scan ohne Textebene, kann dauerhaft scheitern.
Schritt 4: Fragen stellen
Schick deine Anfrage wie gewohnt mit derselben external_identifier. Das Brain zieht die passenden Abschnitte aus den Dateien dieser Person heran, siehe Brain nutzen: Unterhaltungen je Endnutzer speichern und fortsetzen. Die Dateien eines Endnutzers sieht nur dieser Endnutzer, nie ein anderer.
Dateitypen und Grenzen
- PDF, Word (DOCX, DOC), RTF, Excel (XLSX), PowerPoint (PPTX), Text (TXT), Markdown und CSV
- höchstens 32 MiB je Datei
- höchstens 100 Dateien je Endnutzer
- höchstens 5 GiB für alle Endnutzerdateien deines Teams zusammen
- Dateinamen bis 255 Zeichen
Maßgeblich für den Typ ist die Dateiendung. Andere Endungen lehnt die API mit dem Hinweis unsupported_file_type ab, zu große Dateien mit file_too_large.
Dateien prüfen und einzeln löschen
| Aufgabe | Aufruf |
|---|---|
| alle Dateien eines Endnutzers, neueste zuerst | GET /end_users/{id}/files |
| eine Datei, ohne Inhalt | GET /end_users/{id}/files/{datei} |
| eine Datei löschen | DELETE /end_users/{id}/files/{datei} |
Beim Löschen entfernen wir die Datei und alle daraus gewonnenen Textabschnitte. Danach kann das Brain sie nicht mehr verwenden. Für die Abrechnung des bereits genutzten Speichers bleibt ein Eintrag ohne Dateiname und ohne Inhalt zurück, der in keiner Liste erscheint. Eine unbekannte oder fremde Datei beantworten wir mit 404 file_not_found.
In der Oberfläche siehst du die Dateien unter Endnutzer › Details anzeigen mit Name, Größe und Datum.
Was das kostet
Für das Speichern fällt derzeit keine monatliche Gebühr an. Die Verarbeitung beim Hochladen, zum Beispiel das Erzeugen der Embeddings, wird als Modellverbrauch berechnet. Bei späteren Anfragen kostet die Suche in den Dateien ebenfalls ein wenig, das steckt in usage.cost der jeweiligen Antwort.
Abgrenzung
Endnutzerdateien sind Wissen, auf das das Brain bei Bedarf zugreift. Sie sind getrennt von den Dateien unter /files, die du direkt als Anhang an eine einzelne Nachricht hängst. Eine Datei-ID der Endnutzerdateien funktioniert nicht als file_id in einer Nachricht. Mehr zu Anhängen steht in Bilder, PDFs und Audio an ein Modell schicken.